Skip to content

AliRiaz34/GuitarDex-showcase

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

16 Commits
 
 
 
 

Repository files navigation

GuitarDex

Most guitar apps help you learn songs, but struggle to help you manage them after. Instead of forgetting sonogs over time GuitarDex tracks your practices, reminds you what needs attention and makes maintaining your personal catalog enjoyable.

It combines a Pokémon inspired leveling system with practical tools like imported tabs and chords, a tuner, metronome, chord finder with a scale mode, and a chord editor for custom chord sheets.

Frequently being updated and used daily.

Try it

Visit guitardex.net on your phone, tap share, then "Add to Home Screen" to install it as a standalone app.

(Best experienced on mobile or using Chrome DevTools mobile view)

Login screen

Features

Leveling System

Library view    Song detail view

  • Earn XP by logging practice sessions
  • XP scales with song difficulty, practice duration, your highest level reached, and streak bonuses
  • Songs progress through statuses: Seen → Learning → Refined → Mastered
  • Optional XP boost multiplier (up to 3×) to tune how fast you level up
  • Pin frequently-played songs to the top of the library, with status filters and search
  • Custom filter chips (by artist, difficulty, or tuning) and sort by recent, level, or age
  • Autotune filter — a smart chip that surfaces every song matching the tuning of your last practice session, so you can see what you can play right now without retuning

Decay Mechanic

  • Songs decay if not practiced within grace periods
  • Harder songs decay faster, but decay resistance scales with total practice sessions. The more you've played it, the slower it fades
  • Songs that reach Refined have a minimum floor at level 5
  • Songs that reach Mastered never decay below Refined
  • Decay rate is adjustable (0.5×–2×) so retention can be as forgiving or as demanding as you like
  • Decay can be toggled off entirely from settings

Practice Insights

Practice stats dashboard

  • A stats dashboard that visualizes your practice history with charts
  • Progress view — track XP, levels, and practice time as they build up
  • Decay view — see which songs are fading and which are holding steady

Practice Decks & Jam Decks

Deck detail view

  • Organize songs into custom playlists/decks with drag-and-drop reordering
  • Track average level and total duration per deck
  • Jam Decks: collaborative decks shared with another user, with a request/invite flow and mail notifications

Social & Activity Feed

Social activity feed    Profile view

  • Milestone activity feed — see when friends start learning a song, refine it, or master it
  • Profiles — public library, recent activity, streak, total hours played
  • Friends — follow/follower lists with follow-back, unfollow, and follow-request flows
  • Privacy controls — hide your activity from others' feeds, hide your practice log, mark new songs private by default, and export/import or delete your data from settings

Custom Profile Pictures

Pixel-art profile editor

  • Built-in 9x9 pixel-art editor for designing your own profile icon
  • Saved drawings are preserved alongside preset icons, switch between them in one tap, or jump back into the editor to refine your design

Themes

Dirt theme   Crimson theme

  • Three dark themes: original, dirt, and crimson

Quests

Incoming quest request

  • Send a friend a goal: "learn this song to Refined or Mastered"

Tools

Tuner view    Metronome view

  • Dedicated tuner page and an inline tuner inside the practice widget that auto uses the current song's tuning
  • Built-in metronome with a sample-accurate Web Audio scheduler for rock-solid timing
  • Tap tempo — tap out a beat to set the BPM by feel
  • Accent the first beat and set beats-per-measure

Chord Finder

Chord finder — discovery mode    Chord finder — search mode

  • Interactive SVG fretboard spanning 12 frets, with configurable tuning and capo
  • Discovery mode — tap notes on the fretboard and it identifies the chord(s) you're forming
  • Search mode — chords — pick a root, quality, and optional bass note, and it generates up to 20 playable voicings ranked by how clean they are to fret
  • Search mode — scales — pick a root and a scale type (common / pentatonic / modes) and it maps the scale across the whole neck, then breaks it into hand-position boxes you can cycle through
  • Root drone — hum a sustained root note in scale mode to practise your scales in key
  • Hear any chord or scale out loud with built-in Soundfont audio playback

Chord Sheets

Chord sheet editor

  • Build a chord sheet for any song in a dedicated editor, lyrics with chords floated above the exact word they land on
  • An embedded chord picker lets you place chords straight from the interactive fretboard, no typing
  • Import chords from Ultimate Guitar to seed a sheet in one tap

Tabs

Guitar Pro tab player

  • Import guitar tab straight from UG
  • Tabs sync to YouTube audio so you can follow along note-for-note
  • Change playback speed, use a synced metronome, or loop a few tricky bars.

YouTube Playback & Karaoke

YouTube playback with synced lyrics

  • YouTube player integrated into song and practice views with playback controls
  • Automatic lyrics fetch via lrclib.net
  • Full-page karaoke player with synced lyric scrolling alongside playback
  • Per-word karaoke for songs with Guitar Pro timing each word highlights as it's sung, and you can tap any word to seek there

Cross-Device Sync & PWA Support

  • Installable on mobile devices as a standalone app
  • All progress, songs, decks, and social data synced across devices in real-time via Supabase
  • Seamlessly switch between phone, tablet, and desktop without losing any data

Tech Stack

  • React 19 + Vite + vite-plugin-pwa
  • React Router v7
  • Framer Motion — transitions and animations
  • dnd-kit — drag-and-drop song reordering
  • Supabase — PostgreSQL, Auth, Realtime, Row Level Security
  • Web Audio API + pitchfinder (YIN) — tuner pitch detection and metronome scheduling
  • smplr — Soundfont-based chord audio playback
  • AlphaTab — Guitar Pro tab rendering and playback
  • lrclib.net — lyrics API
  • YouTube IFrame API — embedded playback

About

A pokemon inspired guitar practice tracker, featuring a tuner, metronome, chord tools, and a leveling system meant for phones. With a focus on a minimal retro style and unique feature design.

Resources

Stars

4 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors