# ScoreLabs

ScoreLabs is a professional online music notation editor and analysis platform.
It combines advanced rendering capabilities with AI-powered features like harmonization and sight-reading training.

## Features

- **Notation Editor**: Create and edit music scores directly in the browser. Supports MusicXML import/export.
- **AI Harmonization**: Automatically generate four-part harmonies for melodies.
- **Sight Reading Academy**: Interactive tools to practice reading music for various instruments (Piano, Violin, Guitar, etc.).
- **Library**: A collection of high-quality scores ranging from classical to modern genres.
- **Collaboration**: Share scores with other musicians.
- **Waterfall Mode**: Interactive practice tool for learning piano.
- **PDF to MusicXML**: Convert scanned scores to editable digital formats using AI.

## Developer & Embedding

ScoreLabs provides a powerful embedding API for developers who want to include high-quality music notation in their own sites:

### 1. NPM Package
Developers can use the `@scorelabs/viewer` package:
```bash
npm install @scorelabs/viewer
```
Then import the `ScoreViewer` component in React.

### 2. IFRAME Embedding
Embed the viewer directly:
```html
<iframe 
    src="https://viewer.scorelabs.app/?score=YOUR_SCORE_URL" 
    width="100%" 
    height="600px" 
></iframe>
```

## Key Links

- **Home**: https://scorelabs.app
- **Editor**: https://scorelabs.app/score
- **Library**: https://scorelabs.app/library
- **Sight Reading**: https://scorelabs.app/sight-reading
- **API Reference**: https://scorelabs.app/api-reference
- **Pricing**: https://scorelabs.app/pricing

## Technical Context

The frontend is built with React, TypeScript, and Material UI.
The score viewer uses a custom rendering engine based on VexFlow but highly customized for speed and interactivity.
The backend (Node.js/TypeScript) handles authentication, score storage, and AI processing.

## Contact

For support or inquiries, email: jordi@scorelabs.app