@akanjs/cli v0.0.143
โก AkanJS CLI
The official command-line interface for the AkanJS ecosystem, providing powerful development tools for creating, managing, and deploying modern web applications with ease.
๐ Get Started
Prerequisites
- Node.js >=23.x
- pnpm >=10.x
- docker
- (temporary) access permission to akan-team github organization
How to create your project
npm install -g @akanjs/cli --latest
# or if you want to update, run below
# npm update -g @akanjs/cli --latest
akan create-workspace
# workspace name?
# application name?How to start your project
cd <workspace-name> && akan start <app-name> --openyou can navigate to default webpage
- home: http://localhost:4200
Recipes
# set llm model
akan set-llm
# create module
akan create-module
# create scalar with ai (experimental)
akan create-scalarโจ Features
The @akanjs/cli is a comprehensive development toolkit that streamlines the entire application lifecycle:
๐๏ธ Workspace Management (workspace)
Complete workspace and project management:
- ๐ Project Initialization
create-workspace- Create new AkanJS workspace with organization setupgenerate-mongo- Generate MongoDB configuration and setuplint/lint-all- Code linting with auto-fix capabilities
๐ฑ Application Lifecycle (application)
Full-stack application development and deployment:
๐ง Application Management
create-application- Scaffold new applications with templatesremove-application- Clean application removalsync-application- Synchronize application dependencies
๐๏ธ Build System
build- Complete application buildbuild-backend- Server-side build optimizationbuild-frontend- Client-side build with Next.jsbuild-csr- Client-side rendering buildbuild-ios- iOS native app compilationbuild-android- Android native app compilation
๐ Development Server
start- Full-stack development serverstart-backend- GraphQL backend serverstart-frontend- Next.js frontend server with Turbo supportstart-csr- Client-side rendering serverstart-ios- iOS simulator with live reloadstart-android- Android emulator with live reload
๐ฆ Release Management
release-ios- iOS App Store deploymentrelease-android- Google Play deploymentrelease-source- Source code release with versioning
๐๏ธ Database Operations
dump-database- Database backup across environmentsrestore-database- Database restoration with environment selectionpull-database- Pull remote database locallydbup/dbdown- Local database container management
๐ Library Management (library)
Modular library system for code reusability:
๐ฆ Library Operations
create-library- Create new shared librariesremove-library- Clean library removalsync-library- Synchronize library dependenciesinstall-library- Install existing libraries into workspace
๐ Version Control Integration
push-library- Push library changes to remote repositorypull-library- Pull latest library updates
๐งฉ Module Development (module)
AI-powered module generation and management:
๐ค Smart Module Creation
create-module- Generate modules with AI assistancecreate-scalar- Create scalar data modelsremove-module- Module cleanup with dependency checks
๐จ Component Generation
create-view- Generate React view componentscreate-unit- Create reusable unit componentscreate-template- Generate component templates
๐ Page Generation (page)
Dynamic page scaffolding:
- ๐ Page Management
create-page- Generate Next.js pages with routing
โ๏ธ Cloud Integration (cloud)
Seamless cloud services and AI integration:
๐ Authentication
login/logout- Cloud service authentication- User session and credential management
๐ค AI Development Assistant
set-llm/reset-llm- Configure AI language modelsask- Interactive AI development assistance
๐ Deployment
deploy-akan- Deploy to AkanJS cloud infrastructureupdate- Update CLI and cloud integrations
๐ฆ Package Operations (package)
NPM package management and publishing:
- ๐ง Package Lifecycle
- Package building and optimization
- NPM publishing with versioning
- Dependency management
๐ Usage Examples
Workspace Management
# Create new workspace
akan create-workspace "acme-corp" --app "web-app" --dir "./projects"
# Setup MongoDB for development
akan generate-mongo
# Lint entire workspace
akan lint-all --fixApplication Development
# Create new application
akan create-application "mobile-app" --start
# Start full development environment
akan start web-app --open
# Build for production
akan build web-app
# Start backend only
akan start-backend web-app --open # Opens GraphQL playground
# Build and start mobile app
akan build-ios mobile-app
akan start-ios mobile-app --open --releaseLibrary Management
# Create shared library
akan create-library "ui-components"
# Install existing library
akan install-library "util"
# Update library from remote
akan pull-library "shared" --branch main
# Push library changes (development)
akan push-library "ui-components" --branch feature/new-buttonsAI-Powered Module Creation
# Create module with AI assistance
akan create-module "user-profile" \
--description "User profile management with avatar upload" \
--schema-description "User entity with profile fields and file relationships" \
--ai
# Create scalar data model
akan create-scalar "address" \
--description "Address information for users" \
--schema-description "Street, city, country, postal code fields"
# Generate view components
akan create-view # Interactive selection
akan create-unit # Interactive selectionCloud & AI Integration
# Setup cloud authentication
akan login
# Configure AI assistant
akan set-llm
# Get AI development help
akan ask "How do I implement user authentication with JWT?"
# Deploy to cloud
akan deploy-akanDatabase Operations
# Backup production database
akan dump-database web-app --environment main
# Restore from staging to development
akan restore-database web-app --source develop --target debug
# Pull remote database locally
akan pull-database web-app --env debug --dump
# Start local database
akan dbup๐๏ธ Architecture
The CLI follows a modular command structure:
pkgs/@akanjs/cli/
โโโ src/
โ โโโ workspace/ # Workspace management commands
โ โโโ application/ # Application lifecycle commands
โ โโโ library/ # Library management commands
โ โโโ module/ # AI-powered module generation
โ โโโ page/ # Page scaffolding commands
โ โโโ package/ # NPM package operations
โ โโโ cloud/ # Cloud services integration
โ โโโ templates/ # Code generation templates
โโโ index.ts # CLI entry point
โโโ package.json # Dependencies and configuration๐ค AI-Powered Development
The CLI integrates advanced AI capabilities:
- ๐ง Smart Code Generation - AI analyzes requirements and generates optimized code
- ๐ Schema Intelligence - Automatic database schema generation from descriptions
- ๐ Context-Aware Assistance - AI understands your project structure for better suggestions
- โก Rapid Prototyping - Generate complete modules with business logic in seconds
๐ ๏ธ Advanced Features
- ๐ Hot Reload - Instant development feedback across all platforms
- ๐ฑ Cross-Platform - Build web, iOS, and Android from single codebase
- ๐ฏ TypeScript First - Full TypeScript support with strict type checking
- ๐ GraphQL Integration - Built-in GraphQL server and client generation
- ๐ Security Built-in - JWT authentication, RBAC, and security best practices
- ๐ Performance Monitoring - Built-in performance tracking and optimization
- ๐งช Testing Framework - Integrated Jest and Playwright testing
- ๐ฆ Micro-frontends - Support for modular frontend architecture
๐ค Contributing
- Fork the repository
- Create your feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add amazing CLI feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
๐ License
This project is part of the AkanJS ecosystem. See the main repository for license information.
๐ Related Packages
@akanjs/devkit- Development toolkit and command infrastructure@akanjs/base- Core foundation@akanjs/common- Shared utilities@akanjs/nest- NestJS integrations@akanjs/next- Next.js utilities
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago
5 months ago
6 months ago
6 months ago
6 months ago
6 months ago
6 months ago
6 months ago
7 months ago
7 months ago
7 months ago
7 months ago
7 months ago
7 months ago
7 months ago
7 months ago
7 months ago
7 months ago
7 months ago
7 months ago
7 months ago
7 months ago
7 months ago
7 months ago
7 months ago
7 months ago
7 months ago
7 months ago
7 months ago
7 months ago
7 months ago
7 months ago
7 months ago