Top-level folders

app contains App Router pages, layouts, and global CSS.

components contains reusable UI pieces and showcase renderers.

lib contains navigation data, route catalogs, and documentation data.

public contains static assets that are referenced directly by browser URLs.

app/
components/
lib/
public/
next.config.ts
tsconfig.json
package.json

Route groups

app/app contains dashboard routes under /app.

app/auth/[slug] contains standalone auth routes.

app/pages/misc/[slug] contains standalone misc pages.

app/app/documentation contains the documentation section.

Catalog-driven pages

Forms, components, charts, tables, pages, auth pages, extensions, and wizard examples are driven by catalog files in lib.

A catalog entry usually feeds the index page, dynamic route, and sidebar item at the same time.