# StartupLX Project Structure

```bash
startuplx/
├── .env.example                 # Environment variables template
├── astro.config.mjs             # Astro 3.0 configuration
├── tailwind.config.js           # Tailwind CSS theme & custom styling tokens
├── package.json                 # Project dependencies and build scripts
├── docker-compose.yml           # Full-stack Docker orchestration (Nginx, n8n, Metabase, Postgres, Redis)
│
├── src/                         # Astro.js Production Web Application
│   ├── components/              # UI Components (Hero, Services, HowItWorks, Pricing, KPIDashboard, etc.)
│   ├── layouts/                 # Page Layouts (BaseLayout, Header, Footer)
│   ├── pages/                   # Routes (index.astro, api/lead-capture.ts)
│   ├── styles/                  # Global design system & theme tokens
│   └── lib/                     # Client/API utility modules
│
├── context/                     # Architectural context & sprint standards
│   ├── architecture.md          # Technical stack & system boundaries
│   ├── progress-tracker.md      # Development progress log
│   ├── phase3-plan.md           # Backend Docker & Metabase roadmap
│   ├── ui-context.md            # UI design tokens & style guides
│   └── code-standards.md        # Code quality & testing rules
│
├── database/                    # Database schemas and migrations
│   └── schema.sql               # PostgreSQL tables (leads, clients, projects, invoices, etc.)
│
├── services/                    # Operational service guides & workflow specs
│   ├── dashboard/               # Metabase guides & KPI query definitions
│   ├── integration/             # End-to-end booking & payment flows
│   ├── n8n-workflows/           # Lead qualification & automation flows
│   └── website/                 # Website deployment & build guides
│
├── deployment/                  # Deployment assets & shared-hosting fallbacks
│   ├── api/                     # PHP fallback API handlers (capture.php, kpi.php)
│   ├── deploy-contact-page.sh   # Contact page deployment script
│   └── .htaccess                # Security & routing rules
│
├── nginx/                       # Production reverse proxy
│   └── nginx.conf               # Multi-service routing (website, n8n, dashboard)
│
├── scripts/                     # Automation & DevOps CLI utilities
│   ├── provision-vps.sh         # Hetzner VPS initialization
│   ├── setup-docker.sh          # Docker CE setup script
│   ├── progress-check.sh        # Revenue & priority check CLI
│   ├── priority_filter.py       # Revenue impact task ranker
│   └── daily-cron.sh            # Daily automated tasks
│
├── cron/                        # System scheduler definitions
│   └── schedule.conf            # Crontab schedule configuration
│
├── public/                      # Static assets (favicons, public images)
├── dist/                        # Compiled production build output
└── soul.md                      # Core business vision & $7,000/mo architecture
```

## Quick Start Command Stack

```bash
# 1. Local Development
npm install
npm run dev        # Starts Astro dev server on http://localhost:4321

# 2. Production Build Verification
npm run build      # Compiles static and SSR assets to /dist

# 3. Docker Infrastructure Stack
docker-compose up -d  # Launches Nginx, n8n, Metabase, Postgres, Redis

# 4. Daily Revenue & Priority Check
./scripts/progress-check.sh
python3 scripts/priority_filter.py --today
```