Next Gen

the next generation of template

The issue is that Turborepo expects a specific structure. Here's the correct setup:

Path dir

npm run gen default for turbo repo apps/

. for root custom test/

Correct Structure for External Generators

turbo-generators/
├── package.json
├── turbo/
│   └── generators/
│       ├── config.ts       # Main config file
│       └── templates/
│           ├── component.hbs
│           └── package.hbs

The key is: Generators must be inside turbo/generators/ directory!

Step-by-Step Fix:

1. Restructure your repo:

cd turbo-generators
mkdir -p turbo/generators
mv config.ts turbo/generators/
mv templates turbo/generators/

2. Update package.json:

{
  "name": "turbo-generators",
  "version": "1.0.0",
  "type": "module",
  "dependencies": {
    "@turbo/gen": "^2.6.3"
  },
  "exports": {
    ".": "./turbo/generators/config.ts"
  }
}

3. Fix config.ts path references:

// turbo/generators/config.ts
import type { PlopTypes } from "@turbo/gen";

export default function generator(plop: PlopTypes.NodePlopAPI): void {
  plop.setGenerator("component", {
    description: "Create a new component",
    prompts: [
      {
        type: "input",
        name: "name",
        message: "Component name?",
      },
    ],
    actions: [
      {
        type: "add",
        path: "src/components/{{pascalCase name}}.tsx",
        templateFile: "templates/component.hbs", // Relative to config.ts
      },
    ],
  });
}

4. Reference in your monorepo's turbo.json:

{
  "$schema": "https://turbo.build/schema.json",
  "generators": {
    "source": "git+https://github.com/your-org/turbo-generators.git"
  }
}

5. For local development (before pushing to git):

{
  "generators": {
    "source": "../turbo-generators"
  }
}

Or install it locally:

# In your monorepo
npm install ../turbo-generators --save-dev

Then:

{
  "generators": {
    "source": "node_modules/turbo-generators"
  }
}

6. Test it:

cd your-monorepo
turbo gen

You should now see your generators listed!

Quick Development Workflow:

Option A - Local Path:

// turbo.json in your monorepo
{
  "generators": {
    "source": "../turbo-generators"
  }
}

Option B - npm link:

cd turbo-generators
npm link

cd ../your-monorepo
npm link turbo-generators

The main issue was the missing turbo/generators/ folder structure. Turborepo looks specifically for that path! 🎯