CLI Overview
The Asena CLI is a powerful command-line tool that streamlines Asena application development. It handles project scaffolding, code generation, building, and development workflows.
What is Asena CLI?
Asena CLI provides essential tools for building and managing Asena applications:
- Project Scaffolding - Create new projects with complete setup
- Code Generation - Generate controllers, services, middleware, and more
- Build System - Bundle your application for production
- Development Mode - Hot reload and automatic compilation
- Multi-Adapter Support - Works with both Ergenecore and Hono adapters
Key Features
🚀 Quick Project Setup
Create a fully configured Asena project in seconds with interactive prompts for adapter selection, ESLint, and Prettier setup.
🔧 Code Generation
Quickly generate boilerplate code for:
- Controllers with route handlers
- Services with business logic
- Middleware for request processing
- Config classes for server configuration
- WebSocket namespaces for real-time features
⚡ Fast Development
Development mode with automatic building and component registration. No manual imports needed—the CLI discovers and registers all your components automatically.
📦 Production Builds
Bundle your application with Bun's fast bundler, with full control over minification, source maps, and output options.
Getting Started
Install the CLI globally:
bun install -g @asenajs/asena-cliCreate your first project:
asena createStart developing:
cd my-project
asena dev startDocumentation
- Installation - Install and verify the CLI
- Commands - All available commands and options
- Configuration - Configure your project
- Examples - Step-by-step tutorials
Requirements
- Bun Runtime - v1.2.8 or higher
- TypeScript - v5.8.2 or higher (installed automatically)
Related Resources
- Get Started Guide - Complete beginner's guide
- Adapters Overview - Choose between Ergenecore and Hono
- CLI Examples - See project structure examples
Next Steps: