# BalletPreps - AI Agent Information

> BalletPreps is an interactive educational platform for learning ballet terminology across multiple international dance syllabus methods.

## Overview

BalletPreps helps ballet students, teachers, and enthusiasts learn and master ballet terminology through interactive tools including flashcards, quizzes, and a comprehensive free ebook.

## Supported Ballet Schools/Methods

- **CSTD** (Commonwealth Society of Teachers of Dancing) - Australian-based international syllabus
- **RAD** (Royal Academy of Dance) - UK-based classical ballet training method
- **Trinity** (Trinity College London) - International dance examination board
- **ISTD** (Imperial Society of Teachers of Dancing) - UK-based dance education organization

## Grade Levels Available

- Pre-Primary (ages 4-5)
- Primary (ages 5-6)
- Grade 1 through Grade 8

## Key Features

1. **Interactive Flashcards**: Visual learning cards with ballet term definitions and images
2. **Quiz Game**: Test knowledge with multiple-choice questions on ballet terminology
3. **Free Ebook Download**: Comprehensive 50+ page PDF guide with all terminology
4. **Grade-Specific Content**: Syllabus breakdown for each grade level
5. **AI Ballet Assistant**: Chat with an AI tutor for ballet questions

## Ballet Terminology Categories

### Positions
- First Position, Second Position, Third Position, Fourth Position, Fifth Position
- Parallel Position
- En Face, Croisé, Effacé

### Arm Positions
- Bras Bas, First Position Arms, Second Position Arms
- High Fifth (Fifth en Haut), Low Fifth (Fifth en Bas)
- Port de Bras

### Basic Movements
- Plié (demi-plié, grand plié)
- Tendu (battement tendu)
- Relevé
- Échappé
- Chassé
- Assemblé

### Intermediate/Advanced Movements
- Pirouette (en dehors, en dedans)
- Fouetté
- Grand Battement
- Grand Jeté
- Arabesque
- Attitude
- Passé (Retiré)

### Movement Qualities
- Adagio (slow, sustained movements)
- Allegro (fast, brisk movements)
- En Croix (in the shape of a cross)

## API/Data Access

BalletPreps provides a public REST API for programmatic access to ballet terminology data.

### Base URL
`https://wravugjpibysvvcvssfr.supabase.co/functions/v1/ballet-api`

### Endpoints

**GET /** - API documentation and statistics
**GET /schools** - List all ballet schools (CSTD, RAD, Trinity, ISTD)
**GET /grades** - List all grade levels (Pre-Primary to Grade 8)
**GET /categories** - List terminology categories
**GET /terms** - Get ballet terminology with filters:
  - `?grade=grade-1` - Filter by grade
  - `?difficulty=beginner` - Filter by difficulty (beginner/intermediate/advanced)
  - `?category=jumps` - Filter by category
  - `?search=pirouette` - Search terms and definitions

### Example Requests
```
GET /ballet-api/terms?grade=grade-1&difficulty=beginner
GET /ballet-api/terms?category=turns
GET /ballet-api/schools
```

### Response Format
All responses return JSON with `success`, `data`, and `count` fields.

## Contact

For educational partnerships or content licensing inquiries, visit the website.

## Technical Stack

- React + TypeScript
- Vite build system
- Tailwind CSS
- Supabase backend

## Content Updates

Ballet terminology content is regularly reviewed and updated to align with current syllabus standards from each dance organization.

## Usage Rights

Educational content is provided free for personal learning. Commercial use requires permission.