Skip to content

allansomensi/setlyst-web

Setlyst Web

A modern, stage-ready setlist management platform — built with Next.js and optimized for performance.

Built with Next.js Built with TypeScript License


Setlyst Web is the frontend for the Setlyst ecosystem. It provides an intuitive dashboard for musicians to manage their song library, organize setlists, and access a high-performance Live Mode designed specifically for use on stage.


🎯 Motivation

Managing paper setlists or generic note apps during a concert is prone to error and lacks organization. Musicians need a dedicated tool that handles song structures, lyrics, and metadata, while providing a distraction-free interface when the lights go up.

Setlyst was built to be fast, responsive, and reliable enough for professional use.


✨ Features

⚠️ Setlyst is in active development. Features marked 🚧 are planned but not yet implemented.

  • Dashboard — Centralized management of Artists, Songs, and Setlists.
  • Live Mode — High-contrast, distraction-free performance viewer.
  • ChordPro Support — Dynamic rendering of lyrics and chords.
  • Authentication — Secure access via NextAuth.
  • Responsive Design — Optimized for desktops, tablets, and mobile phones.
  • Multi-language — Full support for English and Portuguese (i18n).
  • PDF Export — Generate printable versions of your setlists.
  • 🚧 Offline Support — Access your setlists even without an internet connection.
  • 🚧 Setlist Sharing — Collaborative editing with band members.

🛠️ Tech Stack


📥 Installation

Prerequisites: Node.js 18+ and a running instance of the Setlyst API.

  1. Clone the repository:

    git clone [https://github.com/allansomensi/setlyst-web](https://github.com/allansomensi/setlyst-web)
    cd setlyst-web
  2. Install dependencies:

    npm install
  3. Configure environment:

    Create a .env.local file based on .env.example:

    NEXT_PUBLIC_API_URL=your_api_url
    NEXTAUTH_URL=http://localhost:3000
    NEXTAUTH_SECRET=your_secret
  4. Run the development server

    npm run dev

The application will be available at http://localhost:3000.


🎤 Live Mode

The Live Mode is the heart of Setlyst. It is designed to be used on tablets and smartphones mounted on mic stands. It features:

  • Zero Layout Shift: Content remains stable during performance.
  • High Contrast: Readable under stage lights or in dark venues.
  • Stay Awake: Prevents the device from sleeping during use.

🤝 Contributing

Contributions are very welcome! Setlyst is a community-driven project, and we appreciate help with:

  • 🐛 Bug Fixes: Identifying and fixing frontend or integration issues.
  • Feature Requests: Suggesting and implementing new tools for musicians.
  • 🎨 UI/UX: Improving the design, accessibility, and responsiveness.
  • 🌍 Translations: Helping us reach more musicians by improving i18n support.

Please check our CONTRIBUTING.md for detailed guidelines on our development workflow and commit standards. 📜


⚖️ Legal

Setlyst is an open-source project created by musicians for musicians. 🎸

This project is not affiliated with, endorsed by, or sponsored by any instrument or software manufacturer. All product names, logos, and brands are property of their respective owners and are used here strictly for descriptive and nominative purposes.

Setlyst is released under the MIT License. 📜