Nx Workspace

Nx Workspace Management

Quick Start

Exploring workspace: nx show projects and nx show project <name> --json
Running tasks: nx <target> <project> (e.g., nx build my-app)
Affected analysis: nx show projects --affected or nx affected -t <target>

Note: Prefix commands with npx/pnpx/yarn if nx isn't installed globally.

Core Commands

List and Explore Projects

# List all projectsnx show projects
# Filter by type, pattern, or targetnx show projects --type appnx show projects --projects "apps/*"nx show projects --withTarget build
# Find affected projectsnx show projects --affected --base=main

Get Project Information

Critical: Always use nx show project <name> --json for full resolved configuration. Do NOT read project.json directly - it contains only partial configuration.

# Get full configurationnx show project my-app --json
# Extract targetsnx show project my-app --json | jq '.targets | keys'

Configuration schemas:

• Workspace: node_modules/nx/schemas/nx-schema.json
• Project: node_modules/nx/schemas/project-schema.json

Run Tasks

# Run specific projectnx build web --configuration=production
# Run affectednx affected -t test --base=main
# View dependency graphnx graph

Workspace Architecture

workspace/├── apps/              # Deployable applications├── libs/              # Shared libraries│   ├── shared/        # Shared across scopes│   └── feature/       # Feature-specific├── nx.json            # Workspace configuration└── tools/             # Custom executors/generators

Library Types

Detailed Resources

Configuration: See reference/configuration.md [blocked] for:

• nx.json templates and options
• project.json structure
• Module boundary rules
• Remote caching setup

Commands: See reference/commands.md [blocked] for:

• Complete command reference
• Advanced filtering options
• Common workflows

CI/CD: See reference/ci-cd.md [blocked] for:

• GitHub Actions configuration
• GitLab CI setup
• Jenkins, Azure Pipelines, CircleCI examples
• Affected commands in pipelines

Best Practices: See reference/best-practices.md [blocked] for:

• Do's and don'ts
• Complete troubleshooting guide
• Performance optimization
• Migration guides

Common Workflows

"What's in this workspace?"

nx show projects --type app  # List applicationsnx show projects --type lib  # List libraries

"How do I run project X?"

nx show project X --json | jq '.targets | keys'

"What changed?"

nx show projects --affected --base=main

Quick Troubleshooting

• Targets not showing: Use nx show project <name> --json, not project.json
• Affected not working: Ensure git history available (fetch-depth: 0 in CI)
• Cache issues: Run nx reset

For detailed troubleshooting, see reference/best-practices.md [blocked].