do.dev Project Documentation

Welcome to the do.dev application documentation. This directory contains all technical documentation for the do.dev platform, organized by category for easy navigation.

🚨 CRITICAL - READ FIRST

Before doing ANY work on this project, you MUST read these documents:

1. TENETS.md - Core development principles that guide every decision
2. development/GIT_PREFERENCES.md - Git workflow (commit = git add -A, NEVER push without permission)
3. development/TYPESCRIPT_BEST_PRACTICES.md - TypeScript guidelines (ESSENTIAL for Vercel deployment)
4. architecture/CONVEX_MULTI_PROJECT_ARCHITECTURE.md - Multi-Convex architecture (REQUIRED for any Convex work)

📂 Documentation Structure

🏗️ Architecture

System design, architecture decisions, and structural documentation for the do.dev application.

• CONVEX_MULTI_PROJECT_ARCHITECTURE.md ⭐ - Multi-deployment Convex setup
• PROJECT_STRUCTURE.md - Complete project structure
• RBAC_DASHBOARD_DESIGN.md - Role-based access control design
• RBAC_IMPLEMENTATION_SUMMARY.md - RBAC implementation details
• View all architecture docs →

🔐 Authentication

Everything related to authentication, authorization, and user management for the do.dev application.

• README.md ⭐ - Authentication overview and index
• CLERK_AUTHENTICATION_ARCHITECTURE.md - Clerk integration architecture
• APP_SPECIFIC_AUTH.md - Multi-tenant authentication setup
• GOOGLE_AUTH_SETUP.md - OAuth configuration
• EMAIL_SETUP.md - Email authentication setup
• View all authentication docs →

🛠️ Development

Development guidelines, standards, and best practices.

• TENETS.md 🎯 - Core development principles (MUST READ)
• GIT_PREFERENCES.md ⚠️ - Git workflow (MUST READ)
• TYPESCRIPT_BEST_PRACTICES.md ⚠️ - TypeScript guidelines
• UI_STANDARDS.md - UI/UX guidelines
• CODEBASE_STATUS.md - Current codebase state
• ROLES.md - User roles documentation
• View all development docs →

🌐 Infrastructure

Deployment, hosting, and infrastructure configuration.

• README.md ⭐ - Infrastructure overview and current status
• TRAEFIK_AUTOMATIC_FAILOVER.md ✅ - ACTIVE: Automatic failover guide (IMPLEMENTED)
• TRAEFIK_MIGRATION_GUIDE.md - Caddy to Traefik migration
• VERCEL_DEPLOYMENT_GUIDE.md - Deployment instructions
• DNS_DESIGN.md - DNS architecture
• MULTI_UPSTREAM_FAILOVER_ARCHITECTURE.md - Failover architecture
• View all infrastructure docs →

✨ Features

Feature-specific documentation and implementation guides for the do.dev application.

• SERVER_WIZARD_IMPLEMENTATION.md - Server management wizard
• ONBOARDING.md - User onboarding flow
• SEO.md - SEO implementation
• View all feature docs →

🗄️ Archive

Older documentation kept for historical reference.

• Contains outdated or superseded documentation
• View archived docs →

🚀 Quick Start Guides

For New Developers

1. Read the Git Preferences
2. Review TypeScript Best Practices
3. Understand the Project Structure
4. Check Codebase Status

For Authentication Work

1. Start with Authentication README
2. Review Convex Multi-Project Architecture
3. Follow relevant setup guides in the authentication folder

For Deployment

1. Read Vercel Deployment Guide
2. Configure environment variables per authentication docs
3. Test TypeScript compilation locally first

📊 Documentation Stats

• Active Documents: ~30 (focused on dodev project)
• Archived Documents: 16
• Categories: 5 main categories + archive
• Last Major Cleanup: August 14, 2025
• Cleanup Results:
  • Project Extraction: Cleaned up monorepo to single dodev project
  • Removed: Project-specific docs for deleted applications
  • Updated: All documentation to reflect single-project structure
  • Focus: Documentation now specifically targets dodev functionality

🔍 Finding Documentation

By Topic

• Git/GitHub → development/GIT_PREFERENCES.md
• TypeScript → development/TYPESCRIPT_BEST_PRACTICES.md
• Clerk Auth → authentication/
• Convex → architecture/CONVEX_MULTI_PROJECT_ARCHITECTURE.md
• UI Components → development/UI_STANDARDS.md
• Deployment → infrastructure/VERCEL_DEPLOYMENT_GUIDE.md

By Task

• Setting up authentication → authentication/README.md
• Configuring DNS management → infrastructure/DNS_DESIGN.md
• Setting up Traefik proxy → infrastructure/TRAEFIK_AUTOMATIC_FAILOVER.md
• Deploying to Vercel → infrastructure/VERCEL_DEPLOYMENT_GUIDE.md
• Understanding user roles → development/ROLES.md
• Server management → features/SERVER_WIZARD_IMPLEMENTATION.md

💡 Documentation Guidelines

1. Keep docs close to code - Feature docs in feature folders when possible
2. Use clear naming - Descriptive filenames in CAPS_WITH_UNDERSCORES.md
3. Update when changing code - Documentation is part of the PR
4. Archive don't delete - Move outdated docs to archive folder
5. Cross-reference - Link between related documents

---

Remember: Good documentation is as important as good code. Keep it updated! 📚