Skip to content
AdmindekDocs

Folder Structure

Understanding the project layout and where to find things.

Root Directory

The monorepo root contains all framework packages alongside shared configuration:

admindek/
├── packages/
│   ├── theme/         # Shared SCSS design system
│   ├── html/          # HTML/Bootstrap template
│   └── nextjs/        # Next.js application
├── docs/              # Design specs & plans
├── package.json       # Monorepo root
├── pnpm-workspace.yaml
└── CLAUDE.md

Next.js Package

All application code lives under packages/nextjs/:

packages/nextjs/
├── src/
│   ├── app/
│   │   ├── (dashboard)/      # Dashboard pages (sidebar layout)
│   │   ├── (auth)/           # Auth pages (v1 centered, v2 split)
│   │   ├── (marketing)/      # Landing page
│   │   ├── (pages)/          # Error & utility pages
│   │   └── docs/             # Documentation (you're here!)
│   ├── components/
│   │   ├── auth/             # Auth form components
│   │   ├── dashboard/        # Sidebar, header, breadcrumb, etc.
│   │   └── forms/            # Stepper, wizards, editor
│   ├── contexts/             # React context providers
│   ├── hooks/                # Custom hooks
│   └── lib/                  # Navigation, mock data, utilities
├── public/                   # Static assets
└── next.config.ts

Key Files

The most important files in src/lib/:

  • navigation.ts — Defines the sidebar navigation tree — add or reorder menu items here.
  • mock-data.ts — Shared mock data used across dashboard pages (users, stats, activity, etc.).
  • mock-ecommerce.ts — Mock data specific to e-commerce pages (products, orders, cart).
  • docs-navigation.ts — Navigation tree for the docs sidebar — add new doc pages here.

Route Groups

Next.js route groups (the parenthesised folder names) control which layout wraps each section of the app without affecting the URL:

  • (dashboard) — Full chrome — persistent sidebar, top header, and breadcrumb navigation. All dashboard, data table, chart, and feature pages live here.
  • (auth) — Minimal layout with no sidebar. Houses login, register, 2FA, OTP, forgot-password, and lock-screen pages in two visual variants (v1 centered, v2 split-screen).
  • (pages) — Centered, standalone layout for error and utility pages (404, 500, 403, maintenance, coming soon, offline, session expired, rate limited).
  • (marketing) — No application chrome at all. Used for the public-facing landing page.