A modern full-stack monorepo powered by Nx, featuring web frontend, mobile app, backend services, and a type-safe API layer.
🚧 In Development - This project is currently being scaffolded with the following structure:
- frontend - Next.js 15 web application (React 19) - boilerplate
- frontend-e2e - Playwright E2E tests for frontend - boilerplate
- nx-test - Original scaffold app - to be removed
- nx-test-e2e - Original scaffold E2E tests - to be removed
- api - oRPC API layer with Zod validation - starter configured
- apps/web - Production web frontend
- apps/mobile - React Native mobile application
- apps/backend - Node.js/NestJS backend server
- packages/types - Shared TypeScript types
- packages/ui - Shared UI components
This project uses pnpm as its package manager.
# Install dependencies
pnpm install
# Add a dependency to workspace root
pnpm add -w <package>
# Add a dependency to a specific package
pnpm add <package> --filter @nx-test/<package-name># Run the frontend dev server
npx nx dev frontend
# Run the API in development mode
npx nx serve api# Build a specific app
npx nx build frontend
# Build all apps
npx nx run-many -t build
# Build only what changed
npx nx affected -t build# Run unit tests
npx nx test frontend
# Run E2E tests
npx nx e2e frontend-e2e
# Run tests for all projects
npx nx run-many -t test
# Run tests for affected projects only
npx nx affected -t test# Lint a project
npx nx lint frontend
# Format all files
npx nx format:write
# Check formatting without changes
npx nx format:check# Next.js app
npx nx g @nx/next:app my-app
# React Native app
npx nx g @nx/react-native:app mobile-app
# NestJS backend
npx nx g @nx/nest:app backend
# Node.js app
npx nx g @nx/node:app my-service# Shared library in packages/
npx nx g @nx/node:lib my-lib --directory=packages/my-lib
# React component library
npx nx g @nx/react:lib ui --directory=packages/ui
# TypeScript library
npx nx g @nx/js:lib types --directory=packages/types@nx/next- Next.js applications@nx/react- React libraries and components@nx/react-native- React Native mobile apps@nx/node- Node.js applications and libraries@nx/nest- NestJS applications@nx/jest- Unit testing with Jest@nx/playwright- E2E testing with Playwright@nx/eslint- Linting with ESLint
Run npx nx list to see all installed plugins.
Visualize your workspace structure and dependencies:
# Interactive project graph
npx nx graph
# See what's affected by your changes
npx nx affected:graph- Frontend: Next.js 15, React 19, Tailwind CSS
- Mobile: React Native (planned)
- Backend: Node.js/NestJS (planned)
- API Layer: oRPC with Zod validation
- Testing: Jest, Playwright, Testing Library
- Linting: ESLint 9, Prettier
- Type Checking: TypeScript (strict mode)
- Build System: Nx with caching and task orchestration
This workspace is connected to Nx Cloud for distributed caching and task execution.
# Connect to Nx Cloud
npx nx connectInstall the Nx Console extension for your IDE to get a visual interface for running tasks and generating code:
# Show project details
npx nx show project frontend
# Run affected tasks
npx nx affected -t lint,test,build
# Clear Nx cache
npx nx reset
# List available generators
npx nx list @nx/next
# Show help for a generator
npx nx g @nx/next:app --helpSee CLAUDE.md or AGENTS.mdfor development guidelines and project conventions.
MIT