NVJ Turnierplaner

Volleyball tournament organizer for Netzroller Volleyball Jugend (NVJ). Manage teams, rounds, and scoring across Bundesliga and Champions League formats.

Getting Started

Prerequisites

• Node.js (v18 or higher) - install with nvm
• Bun (optional, for package management)

Installation

# Clone the repository
git clone <YOUR_GIT_URL>

# Navigate to the project directory
cd nvj-turnierplaner2

# Install dependencies
npm install
# or with bun
bun install

# Start the development server
npm run dev

The app will be available at http://localhost:8080

Tech Stack

• Vite - Build tool and dev server
• React 18 - UI framework
• TypeScript - Type safety
• shadcn/ui - Component library
• Tailwind CSS - Styling
• React Router - Navigation
• Vitest - Testing framework

Available Scripts

npm run dev          # Start development server (port 8080)
npm run build        # Production build
npm run build:dev    # Development mode build
npm run test         # Run tests once
npm run test:watch   # Run tests in watch mode
npm run lint         # Lint code
npm run preview      # Preview production build

Project Structure

• src/context/ - Global state management (TournamentContext)
• src/pages/ - Page components (Index, Tournament, NotFound)
• src/components/ - Reusable components
• src/components/ui/ - shadcn/ui primitives (do not edit directly)
• src/utils/ - Utility functions (match generation logic)
• src/types/ - TypeScript type definitions

Development Guide

See .github/copilot-instructions.md for detailed architecture documentation and coding conventions.