Development Journey Overview

This section documents the complete development history of Soon, from initial setup to current state. Each guide represents a significant milestone in the project’s evolution.

Purpose

These guides serve multiple purposes:

• Tutorial: New developers can follow along to understand how the project was built
• Context for AI: Provides historical context for AI assistants working on the codebase
• Living Documentation: Grows alongside the project as new features are added
• Decision Log: Records architectural choices and their rationale

Development Timeline

1. Initial Turborepo Setup - Creating the TurboRepo foundation with Bun
2. Astro Documentation Site - Replacing Next.js docs with Starlight
3. Claude Code Integration - Setting up AI-assisted development
4. Professional Claude Code Skills - Adding skills from Sentry and Vercel
5. Convex Backend - Setting up Convex as the backend
6. Turborepo Skill - Adding Turborepo-specific Claude skill
7. shadcn/ui Components - Building the shared UI component library
8. Better Auth Integration - Adding authentication with Better Auth
9. Biome Migration - Migrating from ESLint/Prettier to Biome
10. Vitest Testing Setup - Configuring Vitest for testing
11. Authentication - Implementing the authentication flow
12. Better Convex Migration - Migrating to better-convex patterns
13. Shared Validators Package - Creating shared validation utilities
14. oxlint + Prettier Migration - Replacing Biome with oxlint and Prettier
15. Auto-Generated Skills Docs - Documenting Claude Code skills
16. Better Convex Folder Structure - Fixing folder structure and type inference
17. Things Description & Image - Adding file uploads and descriptions
18. Setting Up CI - GitHub Actions CI/CD with Turborepo caching
19. Testing Better Convex - Using convex-test with Better Convex functions
20. React Testing Library - Frontend component testing with RTL and Vitest
21. Input-Only Validators - Refactoring validators for form-focused validation
22. Shared API Package - Centralizing TanStack Query hooks in @repo/api
23. Better Convex RSC - Server-side prefetching with React Server Components
24. Dark Mode Toggle - Adding theme switching with next-themes
25. Remotion Video App - Programmatic video creation with Remotion

Documentation Pattern

Each guide follows a consistent structure:

• What: What was accomplished
• Why: Rationale behind the decision
• How: Step-by-step implementation
• Commands: Exact commands used (for reproducibility)
• Outcomes: What changed in the codebase
• Context for AI: Key details AI assistants should know

Reading These Guides

• Read sequentially for the full development story
• Jump to specific guides for focused learning
• Use as reference when making similar decisions
• Update guides when revisiting or modifying features