🌪️ Add turbo (#30)

Author: rowanc1

.github/workflows/primary.yml

@@ -17,8 +17,6 @@ jobs:
       - uses: actions/checkout@v4
 
       - uses: pnpm/action-setup@v4
-        with:
-          version: 9
 
       - uses: actions/setup-node@v4
         with:
@@ -32,7 +30,7 @@ jobs:
       - run: pnpm install --frozen-lockfile
 
       # Typecheck codegen scripts (before format/lint possibly change line numbers)
-      - run: pnpm --filter scripts typecheck
+      - run: pnpm --filter @oxa/scripts typecheck
 
       # On push: auto-fix formatting and linting (will be committed)
       - run: pnpm format
@@ -49,22 +47,13 @@ jobs:
       - name: Generate types
         run: pnpm codegen all
 
-      # Typecheck generated code (TypeScript via tsc, Python via ty, Rust via cargo)
-      # Note: oxa-types-ts uses build (not typecheck) to produce dist/*.d.ts for @oxa/core
-      - run: pnpm build
-        working-directory: packages/oxa-types-ts
+      # Typecheck generated code (Python and Rust - TypeScript handled by turbo build)
       - run: uv run ty check src/
         working-directory: packages/oxa-types-py
       - run: cargo check
         working-directory: packages/oxa-types-rs
 
-      # Build and test @oxa/core
-      - run: pnpm --filter @oxa/core typecheck
-      - run: pnpm --filter @oxa/core build
-      - run: pnpm --filter @oxa/core test
-
-      # Build oxa (copy bundled CLI)
-      - run: pnpm --filter oxa build
+      - run: pnpm test
 
       - name: Commit changes
         if: github.event_name == 'push'

.gitignore

@@ -1,6 +1,7 @@
 # Node.js
 node_modules
 dist
+.turbo
 
 # Python
 __pycache__

CONTRIBUTING.md

@@ -69,10 +69,15 @@ pnpm codegen docs      # Generate MyST documentation
 ### Building
 
 ```bash
-# Build all packages
+# Build all packages (uses Turborepo for caching and parallel execution)
 pnpm build
+
+# Clean all packages
+pnpm clean
 ```
 
+**Note:** This project uses [Turborepo](https://turbo.build/) for build orchestration. Turborepo provides intelligent caching and parallel task execution across the monorepo, significantly speeding up builds and tests.
+
 ## Documentation
 
 The documentation uses [MyST](https://mystmd.org) and requires the automated codegen tool to run. To start the documentation use `npm install -g mystmd` and run `myst start` in the `docs/` folder. The online documentation is hosted using Curvenote under https://oxa.dev

package.json

@@ -6,22 +6,29 @@
   "engines": {
     "node": ">=22"
   },
+  "workspaces": [
+    "packages/*",
+    "scripts"
+  ],
   "scripts": {
     "codegen": "tsx scripts/codegen.ts",
-    "format": "prettier --write .",
-    "format:check": "prettier --check .",
-    "lint": "eslint .",
-    "lint:fix": "eslint --fix .",
-    "build": "pnpm -r build",
-    "test": "pnpm -r test"
+    "format": "turbo format",
+    "format:check": "turbo format:check",
+    "lint": "turbo lint",
+    "lint:fix": "turbo lint:fix",
+    "build": "turbo build",
+    "test": "turbo test",
+    "clean": "turbo clean"
   },
   "devDependencies": {
     "@eslint/js": "^9.39.2",
     "eslint": "^9.39.2",
     "prettier": "^3.7.4",
     "tsx": "^4.21.0",
+    "turbo": "^2.0.0",
     "typescript": "^5.9.3",
     "typescript-eslint": "^8.50.0",
     "vitest": "^4.0.16"
-  }
+  },
+  "packageManager": "pnpm@9.0.0"
 }

packages/oxa-core/package.json

@@ -19,7 +19,12 @@
     "build": "tsc && cp ../../schema/schema.json dist/ && pnpm run build:bundle",
     "build:bundle": "esbuild src/cli.ts --bundle --platform=node --target=node22 --format=cjs --outfile=dist/cli.bundle.cjs --banner:js='#!/usr/bin/env node' --log-override:empty-import-meta=silent",
     "test": "vitest run",
-    "typecheck": "tsc --noEmit"
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist",
+    "format": "prettier --write \"src/**/*.ts\"",
+    "format:check": "prettier --check \"src/**/*.ts\"",
+    "lint": "eslint .",
+    "lint:fix": "eslint --fix ."
   },
   "dependencies": {
     "oxa-types": "workspace:*",

packages/oxa-types-ts/package.json

@@ -14,7 +14,12 @@
   ],
   "scripts": {
     "typecheck": "tsc --noEmit",
-    "build": "tsc"
+    "build": "tsc",
+    "clean": "rm -rf dist",
+    "format": "prettier --write \"src/**/*.ts\"",
+    "format:check": "prettier --check \"src/**/*.ts\"",
+    "lint": "eslint .",
+    "lint:fix": "eslint --fix ."
   },
   "keywords": [
     "oxa",

packages/oxa/package.json

@@ -10,7 +10,8 @@
     "dist"
   ],
   "scripts": {
-    "build": "rm -rf dist && mkdir -p dist && cp ../oxa-core/dist/cli.bundle.cjs dist/cli.cjs && cp ../oxa-core/dist/schema.json dist/"
+    "build": "rm -rf dist && mkdir -p dist && cp ../oxa-core/dist/cli.bundle.cjs dist/cli.cjs && cp ../oxa-core/dist/schema.json dist/",
+    "clean": "rm -rf dist"
   },
   "keywords": [
     "oxa",
@@ -24,6 +25,9 @@
     "url": "git+https://github.com/oxa-dev/oxa.git",
     "directory": "packages/oxa"
   },
+  "devDependencies": {
+    "@oxa/core": "workspace:*"
+  },
   "engines": {
     "node": ">=22"
   }

pnpm-lock.yaml

@@ -3,7 +3,12 @@
   "private": true,
   "type": "module",
   "scripts": {
-    "typecheck": "tsc --noEmit"
+    "typecheck": "tsc --noEmit",
+    "test": "pnpm run typecheck",
+    "format": "prettier --write \"*.ts\" \"lib/**/*.ts\"",
+    "format:check": "prettier --check \"*.ts\" \"lib/**/*.ts\"",
+    "lint": "eslint .",
+    "lint:fix": "eslint --fix ."
   },
   "dependencies": {
     "ajv": "^8.17.1",

scripts/package.json

@@ -0,0 +1,28 @@
+{
+  "$schema": "https://turborepo.org/schema.json",
+  "tasks": {
+    "build": {
+      "dependsOn": ["^build"],
+      "outputs": ["dist/**", ".next/**", "api/**", "public/build/**"]
+    },
+    "clean": {
+      "outputs": []
+    },
+    "format": {
+      "outputs": []
+    },
+    "format:check": {
+      "outputs": []
+    },
+    "lint": {
+      "outputs": []
+    },
+    "lint:fix": {
+      "outputs": []
+    },
+    "test": {
+      "dependsOn": ["build"],
+      "outputs": []
+    }
+  }
+}