Build Process The Money monorepo uses Turborepo to orchestrate builds across all apps and packages. This ensures that builds are fast, cached, and respect dependencies.
Building All Apps To build all applications and packages:
This runs the turbo run build command, which:
Analyzes the dependency graph
Builds packages before apps that depend on them
Runs builds in parallel when possible
Caches outputs for faster subsequent builds
Building Individual Apps You can build a specific app using Turborepo’s --filter flag:
Build a Single App # Build just the web app pnpm build --filter=web # Build just the secure app pnpm build --filter=secure # Build just the cashgap app pnpm build --filter=cashgap # Build just the docs app pnpm build --filter=docs
Build with Dependencies To build an app and all its dependencies:
pnpm build --filter=secure...
The ... suffix tells Turborepo to include all dependencies in the build.
Build Configuration The build process is configured in turbo.json:
{ "tasks" : { "build" : { "dependsOn" : [ "^build" ], "inputs" : [ "$TURBO_DEFAULT$" , ".env*" ], "outputs" : [ ".next/**" , "!.next/cache/**" ] } } }
Key Configuration Options
dependsOn: ["^build"]inputsoutputs.next directories)env
Environment Variables The build process requires certain environment variables to be set. These are defined in turbo.json:
All environment variables listed in turbo.json must be available during the build, even if they’re empty. Missing variables may cause the build to fail or produce incorrect results.
Required Build Variables # Database MONGODB_URI = your-mongodb-connection-string # Authentication & Security JWT_SECRET = your-jwt-secret JWT_REFRESH_SECRET = your-refresh-secret AUTH_SECRET = your-nextauth-secret # OAuth (if using Google Sign-In) GOOGLE_CLIENT_ID = your-google-client-id GOOGLE_CLIENT_SECRET = your-google-client-secret # App Configuration NEXT_PUBLIC_APP_URL = https://your-app-url.com ALLOWED_ORIGIN = https://your-app-url.com # Email (SMTP) SMTP_HOST = smtp.gmail.com SMTP_PORT = 587 SMTP_SECURE = false SMTP_USER = [email protected] SMTP_PASSWORD = your-smtp-password SMTP_FROM = [email protected] # Environment NODE_ENV = production
See Environment Variables for detailed descriptions.
Build Outputs Each Next.js app produces build artifacts in its .next directory:
apps/ web/.next/ # Web app build output secure/.next/ # Secure app build output cashgap/.next/ # CashGap app build output docs/.next/ # Docs app build output
What’s Included
Optimized JavaScript bundles : Minified and tree-shakenStatic assets : Images, fonts, and other static filesServer components : React Server Components (RSC) payloadsBuild manifest : Metadata about the build
The .next/cache directory is excluded from Turborepo’s cache to avoid conflicts and reduce cache size.
Build Optimization Turborepo Caching Turborepo caches build outputs to speed up subsequent builds:
Local cache : Stored in node_modules/.cache/turboRemote cache : Optional, can be configured with Vercel or custom remote cache
To clear the cache:
Incremental Builds Turborepo only rebuilds what changed:
If you modify a package, only apps depending on it are rebuilt
If you modify an app, only that app is rebuilt
Unchanged packages and apps use cached outputs
Parallel Execution Turborepo runs builds in parallel when there are no dependencies:
# These can build in parallel: # - web (no dependencies) # - docs (no dependencies) # While secure and cashgap wait for @repo/auth and @repo/ui
Production Build Steps
Ensure environment variables are set
Verify all required environment variables are configured: # Check your .env file or CI/CD environment cat .env
Run type checking
Catch TypeScript errors before building:
Build all apps
Run the production build: This may take a few minutes on the first run. Subsequent builds will be faster due to caching.
Verify build outputs
Check that .next directories were created: Starting Production Servers After building, you can start production servers:
# Start a specific app cd apps/secure pnpm start # Or use turbo to start all apps pnpm --filter secure start
The production server:
Serves optimized, minified assets
Uses production React builds
Enables optimizations like compression
CI/CD Integration Example GitHub Actions workflow:
name : Build on : [ push , pull_request ] jobs : build : runs-on : ubuntu-latest steps : - uses : actions/checkout@v3 - uses : pnpm/action-setup@v2 with : version : 9.0.0 - uses : actions/setup-node@v3 with : node-version : 18 cache : 'pnpm' - name : Install dependencies run : pnpm install - name : Type check run : pnpm check-types - name : Lint run : pnpm lint - name : Build run : pnpm build env : MONGODB_URI : ${{ secrets.MONGODB_URI }} JWT_SECRET : ${{ secrets.JWT_SECRET }} # ... other secrets
Troubleshooting Build Failures TypeScript errors # Run type checking to see all errors pnpm check-types
Missing environment variables Ensure all variables in turbo.json are set:
# Check if variables are available echo $MONGODB_URI echo $JWT_SECRET
Out of memory errors Increase Node’s memory limit:
NODE_OPTIONS = "--max-old-space-size=4096" pnpm build
Cache Issues If you suspect cache corruption:
# Clear Turbo cache pnpm turbo clean # Clear Next.js cache rm -rf apps/ * /.next # Rebuild pnpm build
Dependency Issues If builds fail due to dependency problems:
# Clean install rm -rf node_modules pnpm-lock.yaml pnpm install pnpm build
Next Steps
Deployment Overview Learn how to deploy to production
Environment Variables Complete environment variable reference
Database Setup Configure production database