Installation
How to install and use matt-init
Interactive Mode (recommended)
Just run the CLI without any flags:
npx matt-init@latest
You'll get a few prompts:
- Project name: What do you want to call the thing?
- Backend setup
DB + Drizzle + BetterAuth(full-stack)Supabase(coming soon)None(frontend-only)
- Database provider
Turso (SQLite): edge DBNeon (Postgres): (coming soon)Docker Postgres: (coming soon)
- Nix flake: Set up a reproducible Nix flake for dev environment
- Install dependencies: Skip or run
pnpm install - VS Code settings: Adds recommended extensions and workspace config
- Git repo: Optionally initializes git and makes the first commit
CLI Options
matt-init [project-name] [options]
| Option | Description |
|---|---|
--no-git | Skip git repo initialization |
--no-install | Skip installing dependencies |
--no-nix | Skip setting up the Nix flake |
--no-vscode | Skip VS Code workspace and extension setup |
--ci | CI mode: non-interactive, skips prompts |
-y, --default | Use all default answers |
-V, --version | Print version number |
-h, --help | Show CLI help |
Examples
# Recommended: run with prompts
npx matt-init@latest
# Create a new frontend-only app with defaults
npx matt-init@latest my-app --default
# Skip git and dependency installation
npx matt-init@latest my-app --no-git --no-install
# Skip Nix flake setup (Nix is enabled by default in prompts)
npx matt-init@latest my-app --no-nix