Booking Management Monorepo

This is a Turborepo-based monorepo containing a booking management system used in fullstack workshops at Xebia. The project demonstrates modern development practices with a NestJS backend API and is designed to help frontend developers learn fullstack concepts.

Project Structure

├── apps/
│   └── api/          # NestJS backend API
├── packages/         # Shared packages (utilities, configs, etc.)
├── turbo.json        # Turborepo configuration
└── package.json      # Root package.json with workspaces

Prerequisites

• Node.js >= 20.0.0
• Yarn >= 1.22.22

Setup and Installation

1. Clone the repository:

   git clone https://patryk-kowalczyk@bitbucket.org/xebiapoland/fullstack-workshops.git
   cd fullstack-workshops

2. Install dependencies:

   yarn install

Available Commands

Development

• Start all applications in development mode:

  yarn dev

  This will start all applications with hot reload enabled.

Building

• Build all applications:

  yarn build

  Builds all apps and packages in the correct dependency order.

Linting

• Lint all applications:

  yarn lint

Applications

API (apps/api)

A NestJS-based backend API simulating core functionalities of a booking management system.

• Local URL: http://localhost:3000
• API Documentation: http://localhost:3000/api (Swagger UI)
• Technology: NestJS, TypeScript, Swagger

For detailed API documentation and setup instructions, see apps/api/README.md.

Workshop Context

This project is specifically designed for frontend developer workshops at Xebia, providing:

• Real-world API endpoints for booking management
• Interactive API documentation
• Modern monorepo structure with Turborepo
• TypeScript best practices
• Comprehensive development tooling

Development Workflow

1. Start development servers:

   yarn dev

2. Make changes to any application or package

3. Build and test:

   yarn build
   yarn lint