solo-kit/
├── 📱 apps/              # Platform-specific applications
│   ├── web/             # Next.js web application
│   └── mobile/          # Expo mobile application
├── 📦 packages/         # Shared packages and libraries
│   ├── ui/              # Shared UI components
│   ├── utils/           # Platform-agnostic utilities
│   ├── database/        # Database schema and operations
│   └── eslint-config/   # Shared ESLint configuration
├── 🛠️ config/           # Project-wide configuration
├── 📚 docs/             # Documentation files
├── 🔧 scripts/          # Utility scripts
└── 📋 Configuration files

apps/web/
├── 🎨 app/                    # Next.js App Router
│   ├── (auth)/               # Route groups for auth pages
│   │   ├── login/            # Login page
│   │   └── signup/           # Sign-up page
│   ├── (dashboard)/          # Protected dashboard routes
│   │   ├── dashboard/        # User dashboard
│   │   ├── settings/         # User settings
│   │   └── admin/            # Admin pages (role-protected)
│   ├── api/                  # API routes
│   │   ├── auth/             # Authentication endpoints
│   │   ├── users/            # User management API
│   │   └── webhooks/         # Payment and external webhooks
│   ├── documentation/        # Documentation pages (Fumadocs)
│   ├── globals.css           # Global styles
│   ├── layout.tsx            # Root layout
│   ├── loading.tsx           # Global loading UI
│   ├── not-found.tsx         # 404 page
│   └── page.tsx              # Home page
├── 🧩 components/            # React components
│   ├── ui/                   # shadcn/ui components (auto-generated)
│   ├── auth/                 # Authentication components
│   ├── layout/               # Layout components (header, footer, etc.)
│   ├── forms/                # Form components
│   ├── features/             # Feature-specific components
│   │   ├── dashboard/        # Dashboard-specific components
│   │   ├── landing/          # Landing page components
│   │   └── admin/            # Admin panel components
│   └── common/               # Reusable common components
├── 📖 content/               # Content files
│   └── docs/                 # Documentation content (MDX)
├── 🎣 hooks/                 # Custom React hooks
│   ├── use-auth.ts           # Authentication hooks
│   ├── use-theme.ts          # Theme management
│   └── use-local-storage.ts  # Local storage utilities
├── 📚 lib/                   # Utilities and configurations
│   ├── auth.ts               # Authentication configuration
│   ├── db.ts                 # Database client
│   ├── email.ts              # Email service
│   ├── payments.ts           # Payment processing
│   ├── utils.ts              # General utilities
│   ├── validations.ts        # Zod schemas for validation
│   └── constants.ts          # Application constants
├── 🎨 styles/                # CSS and styling files
│   └── globals.css           # Global styles with Tailwind
├── 🌍 messages/              # Internationalization messages
│   ├── en.json               # English translations
│   └── es.json               # Spanish translations
├── 🔧 Configuration files
│   ├── next.config.js        # Next.js configuration
│   ├── tailwind.config.ts    # Tailwind CSS configuration
│   ├── tsconfig.json         # TypeScript configuration
│   └── package.json          # Dependencies and scripts
└── 📋 Other files
    ├── .env                  # Environment defaults
    ├── .env.example          # Environment documentation
    ├── middleware.ts         # Next.js middleware
    └── instrumentation.ts    # Telemetry and monitoring

apps/mobile/
├── 📱 app/                   # Expo Router structure
│   ├── (auth)/              # Authentication screens
│   │   ├── login.tsx        # Login screen
│   │   └── signup.tsx       # Sign-up screen
│   ├── (tabs)/              # Tab navigation
│   │   ├── dashboard.tsx    # Dashboard screen
│   │   ├── profile.tsx      # Profile screen
│   │   └── settings.tsx     # Settings screen
│   ├── _layout.tsx          # Root layout
│   ├── +not-found.tsx       # 404 screen
│   └── index.tsx            # Landing screen
├── 🧩 components/           # Mobile-specific components
│   ├── ui/                  # Mobile UI components
│   ├── navigation/          # Navigation components
│   ├── forms/               # Form components
│   └── common/              # Shared components
├── 🎣 hooks/                # Mobile-specific hooks
│   ├── useAuth.ts           # Authentication hooks
│   └── useTheme.ts          # Theme management
├── 📚 lib/                  # Mobile utilities
│   ├── auth.ts              # Authentication client
│   ├── storage.ts           # Secure storage
│   └── constants.ts         # Mobile constants
├── 🎨 styles/               # Styling
│   └── global.ts            # Global styles
├── 🔧 Configuration files
│   ├── app.config.js        # Expo configuration
│   ├── metro.config.js      # Metro bundler config
│   ├── tsconfig.json        # TypeScript configuration
│   └── package.json         # Dependencies and scripts
└── 📋 Assets
    ├── images/              # Image assets
    └── fonts/               # Custom fonts

packages/ui/
├── src/
│   ├── components/          # React components
│   │   ├── button.tsx       # Button component
│   │   ├── card.tsx         # Card component
│   │   ├── input.tsx        # Input component
│   │   ├── modal.tsx        # Modal component
│   │   └── ...              # More shadcn/ui components
│   ├── hooks/               # Shared hooks
│   │   ├── use-toast.tsx    # Toast notifications
│   │   └── use-media.tsx    # Media queries
│   ├── utils/               # UI utilities
│   │   └── cn.ts            # Class name utility
│   ├── index.ts             # Main exports
│   └── server.ts            # Server-only exports
├── 🔧 Configuration
│   ├── package.json         # Package configuration
│   ├── tsconfig.json        # TypeScript config
│   ├── tailwind.config.ts   # Tailwind config
│   └── tsup.config.ts       # Build configuration
└── 📋 Other files
    └── components.json      # shadcn/ui configuration

packages/utils/
├── src/
│   ├── lib/
│   │   ├── date.ts          # Date formatting utilities
│   │   ├── string.ts        # String manipulation
│   │   ├── number.ts        # Number formatting
│   │   ├── validation.ts    # Common validations
│   │   ├── crypto.ts        # Cryptographic utilities
│   │   └── format.ts        # General formatting
│   ├── constants/
│   │   ├── app.ts           # Application constants
│   │   ├── api.ts           # API constants
│   │   └── validation.ts    # Validation constants
│   ├── types/
│   │   ├── auth.ts          # Authentication types
│   │   ├── user.ts          # User types
│   │   └── common.ts        # Common types
│   └── index.ts             # Main exports
├── 🔧 Configuration
│   ├── package.json         # Package dependencies
│   ├── tsconfig.json        # TypeScript configuration
│   └── tsup.config.ts       # Build configuration
└── 📋 Tests
    └── __tests__/           # Unit tests
        ├── date.test.ts     # Date utility tests
        └── string.test.ts   # String utility tests

packages/database/
├── src/
│   ├── schema/              # Database schema definitions
│   │   ├── users.ts         # User-related tables
│   │   ├── auth.ts          # Authentication tables
│   │   ├── subscriptions.ts # Payment/subscription tables
│   │   ├── audit.ts         # Audit logging tables
│   │   └── index.ts         # Schema exports
│   ├── lib/
│   │   ├── db.ts            # Database client
│   │   ├── migrate.ts       # Migration utilities
│   │   └── seed.ts          # Seed data functions
│   ├── queries/             # Common database queries
│   │   ├── users.ts         # User queries
│   │   ├── auth.ts          # Auth queries
│   │   └── subscriptions.ts # Subscription queries
│   └── index.ts             # Main exports
├── 📁 migrations/           # Database migrations
│   ├── 0001_initial.sql     # Initial schema
│   ├── 0002_add_subscriptions.sql
│   └── meta/                # Migration metadata
├── 🌱 seed/                 # Seed data
│   ├── users.ts             # User seed data
│   └── subscriptions.ts     # Subscription seed data
├── 🔧 Configuration
│   ├── package.json         # Dependencies
│   ├── drizzle.config.ts    # Drizzle configuration
│   ├── tsconfig.json        # TypeScript config
│   └── tsup.config.ts       # Build config
└── 📋 Scripts
    └── migrate.ts           # Migration script

packages/eslint-config/
├── base.js                  # Base ESLint rules
├── react.js                 # React-specific rules
├── next.js                  # Next.js-specific rules
├── react-native.js          # React Native rules
├── package.json             # Package configuration
└── README.md               # Configuration documentation

solo-kit/
├── 📋 Package Management
│   ├── package.json         # Root package configuration
│   ├── pnpm-workspace.yaml  # Workspace configuration
│   └── pnpm-lock.yaml       # Lock file
├── 🔧 Build System
│   ├── turbo.json           # Turborepo configuration
│   └── .npmrc               # NPM configuration
├── 🌍 Environment
│   ├── .env                 # Safe defaults (committed)
│   ├── .env.example         # Documentation
│   └── .env.local           # Sensitive values (ignored)
├── 🎯 TypeScript
│   └── tsconfig.json        # Root TypeScript config
├── 🎨 Code Quality
│   ├── .eslintrc.js         # ESLint configuration
│   ├── .prettierrc          # Prettier configuration
│   └── .editorconfig        # Editor configuration
├── 🐙 Version Control
│   ├── .gitignore           # Git ignore rules
│   └── .gitattributes       # Git attributes
└── 🚀 CI/CD
    └── .github/
        └── workflows/       # GitHub Actions

components/
├── auth/
│   ├── login-form.tsx       # Component
│   ├── login-form.test.tsx  # Test
│   └── login-form.stories.tsx # Storybook story

features/
├── dashboard/
│   ├── components/          # Dashboard components
│   ├── hooks/               # Dashboard hooks
│   ├── lib/                 # Dashboard utilities
│   └── types/               # Dashboard types

// packages/ui/src/index.ts
export { Button } from './components/button';
export { Card } from './components/card';
export { Input } from './components/input';

// Usage
import { Button, Card, Input } from '@packages/ui';

// Instead of: import { db } from '../../../lib/db'
import { db } from '@/lib/db';

🖥️  Component
    ↓ (uses)
🎣  Hook (React Query/SWR)
    ↓ (calls)
🌐  API Route/Server Action
    ↓ (uses)
🗄️  Database Query (Drizzle ORM)
    ↓ (accesses)
🐘  PostgreSQL Database

📦  packages/utils          📦  packages/ui
    ↓ (imported by)            ↓ (imported by)
📱  apps/mobile         📱  apps/web
    ↓ (shares)              ↓ (shares)
🔄  Common Business Logic & UI Components

// ✅ Good: Clear feature grouping
components/
├── features/
│   ├── auth/
│   └── dashboard/
└── common/
    ├── ui/
    └── layout/

// ❌ Avoid: Generic grouping
components/
├── buttons/
├── forms/
└── modals/

✅ Good names:
- user-profile.tsx (kebab-case routes)
- UserProfile.tsx (PascalCase components)
- formatDate.ts (camelCase utilities)
- AUTH_ENDPOINTS.ts (SCREAMING_SNAKE_CASE constants)

❌ Avoid:
- userprofile.tsx
- user_profile.tsx
- UserProfile.js (use .tsx for React)

// ✅ Good: Organized imports
// External libraries
import React from 'react';
import { NextRequest, NextResponse } from 'next/server';

// Internal packages
import { Button } from '@packages/ui';
import { formatDate } from '@packages/utils';

// Local imports
import { db } from '@/lib/db';
import { validateUser } from '@/lib/validation';