Chapter 2

Your First Grit Project

Scaffold a real project, run it, and tour every file it produced.

~26 min total4 lessonsAssignment

By the end of this chapter you'll be able to

Run `grit new` confidently with the right flags
Identify every top-level folder and what lives in it
Start the dev servers and see the app in your browser

Lessons

Module: Scaffolding

Running grit new

The interactive prompts, the flags, and what each kit means.

7measy

Tour of your project

apps/, packages/, root config — what every folder is for.

8measy

Module: Running it

Starting the dev servers

docker compose up, the API, web, admin — running everything together.

6measy

Your first look

Open the URLs, log in with the seeded account, click around.

5measy

Chapter assignment

Scaffold + screenshot tour

Scaffold a project called `my-first-grit`, get all three apps running, log into the admin panel, and take screenshots of: the API health endpoint, the web app homepage, and the admin dashboard. Paste them into notes.md.

See success criteria

Lesson 1 takes ~7 min.

Start chapter

Spot a typo? Have an idea?

Help us improve this chapter. One click opens a GitHub issue with this chapter's URL pre-filled — suggest a clearer wording, report a bug, or request a new lesson. The course keeps improving thanks to learners like you.

Suggest an improvement on GitHub

ch.1: What is Grit and Why?ch.3: The Convention Surface