@se-studio/project-build

Build tools and management scripts for SE Studio projects.

Used by

This package is used by the following apps (and others) for the Tailwind build system, colour setup, and generated types:

• example-empty (this monorepo) – setailwind, setup-colours, type generation
• Customer sites – same CLI tools; see docs/RELATED_PROJECTS.md

Features

Tailwind Build System

• Custom Tailwind CSS v4 build system with file watching
• Automatic grid generation
• Rich text formatting utilities
• Color lookup generation
• Type-safe configuration

Contentful Management Scripts

• Color field validation setup
• CMS configuration utilities
• Environment management

Installation

pnpm add -D @se-studio/project-build

Usage

Tailwind Build System

Add to your package.json:

{
  "scripts": {
    "setailwind": "setailwind"
  }
}

Run the build system:

pnpm setailwind

Dest Flight debug-info patch

React dest Flight copies unnamed _debugInfo without dedup, which can OOM next dest on large CMS pages. From the app directory (so next resolves correctly):

{
  "scripts": {
    "predev": "pnpm typegen && patch-next-flight-debuginfo"
  }
}

Idempotent. When Next/React ship the upstream fix, the command prints a notice and exits 0 — then remove it from predev.

Do not write this file in place under node_modules yourself; the CLI write+renames to avoid corrupting pnpm hardlinks.

Management Scripts

pnpm setup-colours

Agent skills

SE Studio skills are now published as a separate package: @se-studio/skills. Skill source files live in packages/skills/skills/.

In the monorepo, run from the repo root after editing skills:

pnpm skills:validate
pnpm skills:sync

See packages/skills/README.md for frontmatter rules.

In external projects, install skills via the skills CLI:

npx skills add @se-studio/skills

Add to your project’s package.json to auto-sync on pnpm install (skips on CI/Vercel):

"devDependencies": {
  "@se-studio/skills": "^1.0.0",
  "skills-npm": "^1.1.1"
},
"scripts": {
  "prepare": "node -e \"if(process.env.VERCEL||process.env.CI)process.exit(0);process.exit(1)\" || (husky && skills-npm --yes && pnpm skills:update)",
  "skills:sync": "bash scripts/sync-skills.sh",
  "skills:update": "npx -y skills@latest update -y"
}

Commit skills-lock.json after the first pnpm skills:sync. Use pnpm skills:sync manually when adding or updating third-party skills (e.g. Vercel packs) from GitHub. After sync, strip AGENTS.md next to SKILL.md (node scripts/strip-skill-always-on-docs.mjs in core; customer scripts/sync-skills.sh does this automatically).

API Reference

Main Exports

Tailwind Build System

• Tailwind configuration utilities - Functions for generating Tailwind config files
• Grid generation - Automatic grid system generation
• Color utilities - Color lookup and generation functions
• Font utilities - Typography and font configuration

Management Scripts

• Color field validation - Contentful color field setup utilities
• CMS configuration - Contentful management utilities

CLI Commands

setailwind

Tailwind CSS v4 build system with file watching.

Usage:

setailwind [options]

Options:

• --watch, -w - Watch for changes and rebuild automatically
• --config, -c - Path to configuration file

setup-colours

Sets up color field validation in Contentful.

Usage:

setup-colours

seskills sync [target-dir]

Deprecated. Use npx skills add @se-studio/skills instead. See packages/skills/ for the canonical skill sources.

For detailed JSDoc documentation on all exports, see the TypeScript declaration files (.d.ts) in the package.

License

MIT