alepha@docs:~/docs/cli$
cat 1-installation.md | pretty1 min read
Last commit:
#Installation
The Alepha CLI is bundled inside the alepha package. No separate installation required.
#Getting Started
Create a new project:
npx alepha init my-app
This scaffolds a full-stack project — API, React web module, and Tailwind — and adds alepha as a dependency. From then on, run commands from your project directory:
npx alepha dev
npx alepha build
Lost? Run npx alepha -h to see every command at your disposal. It's the cheat sheet you didn't know you needed.
#Why Not Global Install?
Global installation (npm install -g alepha) is not recommended. When working on multiple projects, each may require a different Alepha version. Using npx or project-local scripts ensures each project uses its own version.
#Using npm Scripts
After alepha init, your package.json includes ready-to-use scripts:
json
1{ 2 "scripts": { 3 "dev": "alepha dev", 4 "build": "alepha build", 5 "test": "alepha test", 6 "lint": "alepha lint", 7 "typecheck": "alepha typecheck", 8 "verify": "alepha verify" 9 }10}
Run them with your package manager:
npm run dev
#Requirements
- Node.js 22+ — Alepha uses modern JavaScript features
Check your version:
bash
node --version