Project structure

Learn how the supastarter codebase is structured.

supastarter uses a monorepo structure, which allows you to easily extend your project (for example with a mobile app) and share code and configs between applications.

Basic repository structure

By default the monorepo contains the following apps and packages:

Next.js app boundaries

The marketing site and the product app are separate Next.js apps. Each app has its own:

package.json
next.config.ts
tsconfig.json
layouts
global styles
Playwright config

This keeps public-site concerns and protected product concerns clearly separated.

Configuration

Configuration is scoped to the app or package that owns the behavior:

apps/marketing/config.ts – marketing app configuration
apps/saas/config.ts – SaaS app configuration
package-local config files in shared packages

Within each app, import app config through the local @config alias.

Path aliases

The alias setup is app-specific as well.

`apps/saas`

@config
@auth/*
@organizations/*
@settings/*
@payments/*
@admin/*
@ai/*
@onboarding/*
@shared/*
@i18n/*

`apps/marketing`

@config
@analytics
@home/*
@blog/*
@changelog/*
@legal/*
@shared/*
@i18n/*
content-collections

Learn more about configuration in the configuration documentation.