Marketplace/Forge/Quick Start

Quick Start

This guide takes you from nothing to a running Forge app. You'll need Node.js 20+ and a package manager (npm, pnpm, or bun).

Create an app

Run the create command and answer a couple of prompts:

npx @fozmu/forge create my-app

This scaffolds a new project in my-app/, installs dependencies, and sets up a local environment file.

Choose a template

Forge ships with three starting points. Pick the one closest to what you're building — you can always add the rest later.

?  Pick a template ›
❯  app      Full-stack app with auth + database
   site     Marketing site, static-first
   api      Headless API service only

Start the dev server

cd my-app
npm run dev

Your app is now running at http://localhost:3000.

Make your first change

Open app/page.tsx and edit the heading. The page hot-reloads instantly.

app/page.tsx
export default function Home() {
  return <h1>Hello from Forge ⚒️</h1>;
}

Port already in use?

If 3000 is taken, start on another port with npm run dev -- -p 3001.

What you get

Out of the box your new app already has:

  • A typed routing layer with a working home page and 404.
  • An auth flow at /login backed by sessions.
  • A database client configured against a local Postgres.
  • A forge CLI for migrations, codegen, and deploys.

Where to next