⚡ Optimize Turborepo configuration and improve documentation (#836)

* ⚡ Refactor and optimize turbo.json configuration

- Remove redundant generic task definitions for better clarity
- Streamline api#generate to focus on Supabase files with proper scope
- Add build dependency for pages#test to ensure correct execution order
- Configure comprehensive lint/format inputs covering:
  - Source files and configuration files (*.config.*, *.json)
  - Static assets (public/**) and test files (tests/**)
  - Custom scripts (commands/**)
- Remove README.md exclusion to enable proper spell checking and formatting
- Add exclusions for generated/build artifacts to optimize cache performance

* 📚 Improve README.md command documentation

- Reorganize development commands by workflow phases
- Clarify which commands work at root level vs package-specific
- Add port numbers for development servers
- Group commands logically: servers, build/generate, quality assurance, formatting
- Align documentation with actual turbo.json task configuration

Author: usagizmo

README.md

@@ -123,15 +123,29 @@ After running `pnpm install`, a `.env` file is automatically created from `.env.
 
 ```bash
 # Project Setup
-pnpm install          # Install dependencies (.env file is created automatically)
-
-# Development
-pnpm dev              # Start all apps in development mode
-pnpm generate         # Generate Supabase TypeScript types
-pnpm build            # Build all applications
-pnpm lint             # Run linting across all apps
-pnpm test             # Run tests across all apps
-pnpm format           # Format code with Prettier
+pnpm install                     # Install dependencies (.env file is created automatically)
+
+# Development Workflow
+
+# Start development servers
+pnpm --filter api start          # Start Supabase API (port 54321)
+pnpm dev                         # Start all development servers
+# Or specific apps:
+pnpm --filter web dev            # Start web app only (port 5173)
+pnpm --filter pages dev          # Start static site only (port 3000)
+
+# Build and generate
+pnpm --filter api generate       # Generate TypeScript types from Supabase
+pnpm --filter web build          # Build web application
+pnpm --filter pages build        # Build static site
+
+# Quality assurance
+pnpm lint                        # Run linting across all apps
+pnpm --filter web test           # Test web app
+pnpm --filter pages test         # Test static site
+
+# Code formatting
+pnpm format                      # Format code across all apps
 ```
 
 ### App-Specific Commands

turbo.json

@@ -2,64 +2,14 @@
   "$schema": "https://turbo.build/schema.json",
   "globalDependencies": [".env"],
   "tasks": {
-    "generate": {
-      "dependsOn": ["^generate"],
-      "inputs": ["$TURBO_DEFAULT$", "supabase/**", "scripts/**"],
-      "outputs": ["$generated/**"]
-    },
-    "build": {
-      "dependsOn": ["^build"],
-      "inputs": ["$TURBO_DEFAULT$", "!README.md", "!**/*.test.*", "!**/*.spec.*"],
-      "outputs": ["dist/**", "build/**", ".svelte-kit/**", ".vercel/**", "public/styles.css"]
-    },
-    "dev": {
-      "cache": false,
-      "persistent": true,
-      "dependsOn": ["generate"]
-    },
-    "test": {
-      "dependsOn": ["^build"],
-      "inputs": ["$TURBO_DEFAULT$", "!README.md", "!**/coverage/**"],
-      "outputs": ["coverage/**"]
-    },
-    "lint": {
-      "inputs": ["$TURBO_DEFAULT$", "!README.md", "!**/coverage/**", "!**/dist/**", "!**/build/**"]
-    },
-    "format": {
-      "inputs": ["$TURBO_DEFAULT$", "!README.md", "!**/coverage/**", "!**/dist/**", "!**/build/**"]
-    },
-    "preview": {
-      "dependsOn": ["build"],
-      "cache": false,
-      "persistent": true
-    },
-    "test:watch": {
-      "cache": false,
-      "persistent": true,
-      "interactive": true
-    },
     "api#generate": {
-      "inputs": ["supabase/**", "$TURBO_DEFAULT$"],
-      "outputs": ["$generated/**"]
-    },
-    "api#generate:supabase-types": {
-      "inputs": ["supabase/**"],
-      "outputs": ["$generated/types.ts"],
-      "env": ["DATABASE_URL", "SUPABASE_SERVICE_ROLE_KEY"]
+      "inputs": ["$TURBO_DEFAULT$", "supabase/**"],
+      "outputs": ["$generated/types.ts"]
     },
     "pages#build": {
       "inputs": ["$TURBO_DEFAULT$", "app.css", "public/**", "!public/styles.css"],
       "outputs": ["public/styles.css"]
     },
-    "pages#test": {
-      "dependsOn": ["pages#build"],
-      "inputs": ["public/**", "tests/**", "commands/**"],
-      "outputs": ["tests/external-links.txt"]
-    },
-    "pages#deploy": {
-      "dependsOn": ["pages#build"],
-      "cache": false
-    },
     "web#build": {
       "dependsOn": ["@repo/shared#build"],
       "inputs": ["$TURBO_DEFAULT$", "!README.md", "!**/*.test.*", "!**/*.spec.*"],
@@ -69,6 +19,50 @@
     "@repo/shared#build": {
       "inputs": ["$TURBO_DEFAULT$", "!README.md", "!**/*.test.*", "!**/*.spec.*"],
       "outputs": [".svelte-kit/**", "dist/**"]
+    },
+    "dev": {
+      "cache": false,
+      "persistent": true
+    },
+    "api#test": {
+      "cache": false
+    },
+    "pages#test": {
+      "dependsOn": ["build"],
+      "inputs": ["public/**", "tests/**", "commands/**"],
+      "outputs": ["tests/external-links.txt"]
+    },
+    "lint": {
+      "inputs": [
+        "$TURBO_DEFAULT$",
+        "*.{json,js,ts,config.*}",
+        "public/**",
+        "tests/**",
+        "commands/**",
+        "!**/*.test.*",
+        "!**/*.spec.*",
+        "!**/dist/**",
+        "!**/build/**",
+        "!**/.svelte-kit/**",
+        "!**/.vercel/**",
+        "!**/$generated/**"
+      ]
+    },
+    "format": {
+      "inputs": [
+        "$TURBO_DEFAULT$",
+        "*.{json,js,ts,config.*}",
+        "public/**",
+        "tests/**",
+        "commands/**",
+        "!**/*.test.*",
+        "!**/*.spec.*",
+        "!**/dist/**",
+        "!**/build/**",
+        "!**/.svelte-kit/**",
+        "!**/.vercel/**",
+        "!**/$generated/**"
+      ]
     }
   }
 }