nx-operations

name	nx-operations
description	When you need to run tasks, build projects, or understand the workspace graph using Nx. Use this for all build, lint, and test operations.

Nx Operations & Workspace Management

1. General Guidelines

• Always use Nx: Run tasks via nx run, nx run-many, or nx affected. Do not use underlying tools (like tsc or vite directly) unless debugging a specific issue with them.
• Analyze First:
  • Use npx nx graph to visualize the workspace dependency graph.
  • Use npx nx show project <name> to analyze specific project dependencies before making changes.
  • Use the context7 MCP tool if you are unsure about Nx configuration or best practices.

2. Common Commands

Building

• Build Core App: nx build nextblock
• Build All Libraries: npm run lib-builds (alias for building ui, utils, db, editor, sdk)
• Build Specific Lib: nx build <lib-name> (e.g., nx build ui)

Linting

• Lint Core App: nx lint nextblock
• Lint All: npm run lint

Development

• Serve App: nx serve nextblock (runs the Next.js dev server)

3. Troubleshooting

• If nx start nextblock fails with "Could not find a production build", ensure you have run nx build nextblock first.
• Use nx reset if you suspect cache issues.