Create your first project

This guide walks the most common starting point: turning an idea into a runnable project.

Scaffold the project

The interactive scaffolder is the easiest way to start:

nf new

You’ll be asked for a name, language, package manager, and whether to include a server, Docker files, git, and so on. To skip the prompts, pass the answers as flags:

nf new --name my-game --language ts --package-manager pnpm --server

See nf new for the full flag list.

Look at what was generated

Move into the project and inspect it:

cd my-game

The most important file is nanoforge.config.json, the central configuration the CLI reads for every command. Each field is documented in Configuration file.

Run it

nf dev

Your game now runs locally in development mode. The next guide, Develop locally, goes deeper into the dev workflow.