@getforma/create-app

Scaffold a new Forma application — Rust server + TypeScript frontend, fully wired.

Usage

npx @getforma/create-app my-app
cd my-app

Then:

# Build the frontend
cd admin && npm install && npm run build && cd ..

# Start the Rust server
cargo run

Open http://localhost:3000.

Options

npx @getforma/create-app my-app --template dashboard
npx @getforma/create-app --help
npx @getforma/create-app --version

Templates

| Template | Description | |----------|-------------| | dashboard | DevOps admin panel — 3 pages, 8 API routes, SVG charts, Tailwind CSS, Gruvbox theme | | minimal | Clean slate — Rust server + JSX frontend, ready to build on |

What You Get

A full-stack project with:

• Rust server (src/main.rs) — Axum + forma-server with SSR, asset serving, CSP headers
• TypeScript frontend (admin/src/) — FormaJS with JSX, signals, components
• Build pipeline (admin/build.ts) — @getforma/build with content hashing, compression, manifest
• Everything wired — manifest pipeline, asset serving, and development scripts ready to go

Part of the Forma Stack

Frontend (TypeScript)

| Package | Description | |---|---| | @getforma/core | Reactive DOM library — signals, h(), islands, SSR hydration | | @getforma/compiler | Vite plugin — h() optimization, server transforms, FMIR emission | | @getforma/build | Production pipeline — bundling, hashing, compression, manifest |

Backend (Rust)

| Package | Description | |---|---| | forma-ir | FMIR binary format: parser, walker, WASM exports | | forma-server | Axum middleware: SSR, asset serving, CSP headers |

Full Framework

| Package | Description | |---|---| | @getforma/create-app | This package — scaffolds the full stack |

License

MIT