Neuste Version

README.md

@@ -0,0 +1,65 @@
+# 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](https://github.com/nvm-sh/nvm#installing-and-updating)
+- Bun (optional, for package management)
+
+### Installation
+
+```sh
+# 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
+
+```sh
+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](.github/copilot-instructions.md) for detailed architecture documentation and coding conventions.