@getforma/create-app

@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