pealdevDOCS
Back to peal.dev

SAAS STARTER · PROJECT STRUCTURE

Project structure

A walk-through of the folders that matter and the ones you can ignore until you need them.

We won't pretend every folder is critical — most aren't. Here's what's worth knowing.

Top-level layout

Terminal
src/
├── app/         routes, layouts, server actions
├── components/  UI primitives and bigger blocks
├── lib/         the wiring (auth, db, stripe, email)
├── db/          schema + migrations
└── emails/      transactional templates

Where the magic isn't

Anytime something feels magic, the answer is in src/lib. That's the wiring — auth providers, stripe helpers, db client. Read those files once and the rest of the template makes sense.