/quantone

Primary LanguageTypeScript

QUANTONE

Exploring the Intersections of Music, Mathematics, Rhythms, and Harmony

License: MIT Next.js TypeScript Netlify Status

Overview

QUANTONE is an open-source initiative that bridges the gap between musical expression and mathematical precision. We believe that music is fundamentally mathematical, and mathematics is inherently musical. Our mission is to make these connections visible, tangible, and accessible to everyone—from musicians to mathematicians, from students to researchers.

🎵 Features

  • Interactive Rhythm Explorer: Discover and experiment with various rhythms and their mathematical foundations
  • Mathematical Visualizations: See the geometric and algebraic patterns underlying musical structures
  • Multi-language Support: Available in English, Spanish, and French
  • Educational Resources: Access curated literature and research papers on mathematical music theory

🛠️ Tech Stack

  • Framework: Next.js 14 with App Router
  • Language: TypeScript
  • Styling: Tailwind CSS
  • Internationalization: next-intl
  • Deployment: Netlify

📦 Installation

# Clone the repository
git clone https://github.com/romainframe/quantone.git
cd quantone

# Install dependencies
npm install

# Run development server
npm run dev

# Build for production
npm run build

# Start production server
npm start

🏗️ Project Structure

quantone/
├── app/                    # Next.js app directory
│   └── [locale]/          # Internationalized routes
│       ├── about/         # About page
│       ├── rhythms/       # Rhythms explorer
│       └── page.tsx       # Home page
├── components/            # React components
├── i18n/                  # Internationalization config
├── messages/              # Translation files
├── public/                # Static assets
└── styles/                # Global styles

🌍 Internationalization

Quantone supports multiple languages:

  • English (en)
  • Spanish (es)
  • French (fr)

🤝 Contributing

We welcome contributions from musicians, mathematicians, developers, and anyone interested in the intersection of music and mathematics!

How to Contribute

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add some amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

Development Guidelines

  • Follow the existing code style and TypeScript conventions
  • Add tests for new features when applicable
  • Update documentation as needed
  • Ensure all text content is internationalized

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

  • All the researchers and musicians who have explored the mathematical foundations of music
  • The open-source community for the amazing tools and libraries
  • Contributors who help make this project better

📬 Contact

QUANTONE - Where Mathematics Meets Music 🎵✨