# Project Architecture

> Overview of the project's tech stack, directory structure, and architectural patterns.

- Skill: `aiskillstore/project-architecture` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add aiskillstore/project-architecture`
- Raw SKILL.md: https://api.skillmd.com/api/skills/aiskillstore/project-architecture/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: aiskillstore (https://skillmd.com/u/aiskillstore)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/aiskillstore/project-architecture

---


# Project Architecture & Tech Stack

## Tech Stack
- **Framework**: Next.js 15 (App Router)
- **Language**: TypeScript
- **Styling**: Tailwind CSS v4, CSS Modules (for specific components)
- **Docs/Content**: Docusaurus (in `textbook/` directory)
- **Auth**: Better Auth (`better-auth`)
- **Database**: PostgreSQL (NeonDB)
- **ORM**: Drizzle ORM
- **UI Components**: Lucide React icons, Custom components

## Directory Structure
- `/app`: Next.js App Router pages and layouts.
- `/components`: Reusable UI components.
  - `/auth`: Authentication related components (forms, etc.).
- `/lib`: Utility functions and shared logic.
  - `auth-client.ts`: Better Auth client configuration.
  - `auth.ts`: Better Auth server configuration.
- `/db`: Database schema and connection logic.
- `/drizzle`: Migrations.
- `/textbook`: Docusaurus instance for documentation/content.
  - `/src`: Docusaurus source files.

## Key Patterns
- **Hybrid App**: Combines a Next.js web app (marketing, auth, dashboard) with a Docusaurus documentation site.
- **Auth Integration**: Shared authentication state between Next.js and Docusaurus via cookies/sessions (handled by `AuthBar`).
- **Styling**: Global Tailwind styles in `app/globals.css`. Docusaurus has its own theme in `textbook/src/css/custom.css`.

## Development
- Run root app: `npm run dev:root`
- Run docs app: `npm run dev:docs`
- Run both: `npm run dev`