Docs
Project Structure

Project Structure

An overview of the file structure and organization of the project.

Our projects follow the standard Next.js App Router structure, designed for scalability and maintainability.

File Tree
  • src/
    • app/// Application routes and pages
    • components/// Reusable UI components
    • config/// Static configuration files
    • hooks/// Custom React hooks
    • lib/// Utility functions and libraries
    • types/// TypeScript definitions
    • styles/// Global styles
  • public/ // Static assets (images, fonts)
  • .env // Environment variables
  • next.config.js // Next.js configuration
  • tailwind.config.ts // Tailwind CSS configuration

Key Directories

src/app

Contains all routes, layouts, and page components. We use the App Router's folder-based routing system. Special files like page.tsx, layout.tsx, and loading.tsx reside here.

src/components

Organized by category (e.g., ui for base primitives, layout for headers/footers). The ui folder typically contains Shadcn UI components.

src/lib

Contains helper functions, database clients (e.g., Prisma), and other utilities that don't contain UI logic.