Initialization

Run the next-forge init command:

Terminal
npx next-forge@latest init

You will be prompted for the project name and package manager.

Terminal
$ npx next-forge@latest init

? What is your project named?
? What package manager do you want to use? (Use arrow keys)
pnpm
  npm
  yarn
  bun

This will create a new directory with your project name and clone the repo into it. It will run a setup script to install dependencies and copy .env files. You can read more about environment variables here.

Database

You will need to scaffold the database using the schema defined in packages/database/prisma/schema.prisma:

Terminal
pnpm migrate

CMS

You will need to setup the CMS. Follow the instructions here, but the summary is:

  1. Fork the basehub/next-forge template
  2. Get your Read Token from the “Connect to Your App” page
  3. Add the BASEHUB_TOKEN to your Environment Variables

Development

Run the development server with:

Terminal
pnpm dev

Open the localhost URLs with the relevant ports listed above to see the app, e.g.