🎸 Chorde

Chorde is a modern, responsive songbook application designed for musicians. It allows you to manage your song library using the industry-standard ChordPro format, transpose keys on the fly, and keep your repertoire organized.

✨ Features

• ChordPro Support: Parse and render songs with chord embedding.
• Interactive Chord Library:
  • Browse chords and view multiple finger positions (variations).
  • Strumming Audio Preview: Listen to realistic guitar strum playback with position-based timing.
• Dynamic Transposition: Instantly change the key of any song.
• Smart Song Viewer:
  • Auto-scroll with adjustable speed.
  • Multiple display modes: Chords, Tabs, and Notation.
  • Loop sections for practice.
• Collapsible Navigation: Browse by Keys, Artists, and Genres with item count badges.
• Local Storage: Your library is saved locally in your browser.
• Nashville Number System: View songs in numbers for universal playability.
• Performance: Lazy loading for large song libraries.
• Responsive Design: Works great on desktop and tablets.

🚀 Getting Started

Prerequisites

• Node.js (v18 or higher)
• npm or yarn

Installation

1. Clone the repository:

   git clone https://github.com/your-username/chorde.git
   cd chorde

2. Install dependencies:

   npm install

3. Start the development server:

   npm run dev

4. Open your browser at http://localhost:5174

🛠️ Tech Stack

• Framework: React 19
• Build Tool: Vite
• Language: TypeScript
• Styling: Modular CSS

📖 Documentation

• Song Import Guide
• Library Status

🤝 Contributing

We welcome contributions! Please see CONTRIBUTING.md for details on how to get started.

📄 License

This project is licensed under the MIT License.

chorde