New CW V3

As Creator’s World grew in scale and complexity, managing everything inside a single project became harder. Reusable UI components, documentation, and application logic started mixing together. To solve this and prepare the project for future growth, Creator’s World V3 was migrated to a Turborepo monorepo architecture.

Why the Migration Was Needed

The earlier structure worked well at the beginning but started showing limitations as the project expanded.

To address these challenges, the project moved to a monorepo using Turborepo.

What is Turborepo?

Turborepo is a high-performance build system designed for JavaScript and TypeScript monorepos. It allows developers to manage multiple apps and shared packages efficiently while optimizing builds with caching and parallel task execution.

Some key capabilities include:

New Monorepo Structure

After migrating, the project structure was reorganized into apps and packages.

creators-world/
│
├── apps/
│   ├── web        # Main Next.js application
│   └── docs       # Documentation site
│
├── packages/
│   ├── ui         # Shared UI components
│   ├── eslint     # Shared ESLint configuration
│   └── tsconfig   # Shared TypeScript configuration
│
├── turbo.json
└── package.json

This structure separates runnable applications from reusable packages, making the project easier to maintain and scale.

Apps Directory

The apps folder contains full applications that can run independently.

Each application can share packages while maintaining its own configuration and build process.

Shared Packages

The packages directory stores reusable modules used by multiple apps.

Common shared packages include:

import { Button } from "@repo/ui/components/ui/button";

This approach ensures design consistency and eliminates duplication across apps.

Turborepo Pipeline Configuration

Turborepo manages build tasks using a pipeline defined in the turbo.json configuration file.

{
  "pipeline": {
    "build": {
      "dependsOn": ["^build"],
      "outputs": [".next/**"]
    },
    "dev": {
      "cache": false
    },
    "lint": {},
    "type-check": {}
  }
}

This configuration allows Turborepo to run tasks efficiently while rebuilding only the parts of the project that actually changed.

Improved Developer Experience

One of the biggest improvements after the migration was developer workflow.

pnpm dev

This command starts all applications simultaneously using Turborepo’s task runner.

pnpm dev --filter=web

Developers can also run a specific application independently when needed.

Performance Benefits

Turborepo significantly improves build performance through smart caching and dependency tracking.

This makes development faster and improves CI/CD efficiency.

Final Thoughts

Migrating Creator’s World V3 to a Turborepo monorepo transformed the project architecture. With shared packages, faster builds, and a scalable structure, the platform is now ready to support multiple applications and future expansion.

This migration lays the foundation for a more maintainable and developer-friendly ecosystem as Creator’s World continues to evolve.