How marcentella/plainchord works
PlainChord is a browser-based guitar-learning reference: users explore chord progressions and transition difficulty, learn tablature techniques, or import and play their own tabs. Its main flow runs from tab input through a shared tab model to visual rendering and optional audio playback. The README also documents glossary, theme, and audio chord-detection capabilities. Relationships for unsampled modules are included only where the SOURCE INDEX or README supports them; the development synth page is excluded as a prototype.
Main entry points: acordes/page.tsx Chord Library · tablatura/page.tsx Tab Import Page · chords.ts Chord Library Data · tab.ts Tab Data Model
Components 29
Learning UI
- Landing Page
app/page.tsx - App Layout
app/layout.tsx - Theme Controls
components/PalettePicker.tsx - Technique Glossary
app/glosario/page.tsx - Glossary Detail
components/GlossaryEntryDetail.tsx
Chord Learning
- Chord Library
app/acordes/page.tsx - Progression Input
components/ChordProgressionInput.tsx - Chord Library Data
lib/chords.ts - Chord Diagram
components/ChordDiagram.tsx - Fretboard View
components/Fretboard.tsx - Transition Difficulty
lib/transitionDifficulty.ts - Difficulty Badge
components/TransitionBadge.tsx - Chord Play-Along
lib/useChordPlayAlong.ts
Tab Practice
- Tab Import Page
app/tablatura/page.tsx - Text Tab Parser
lib/parseTab.ts - Guitar Pro Import
lib/importGuitarPro.ts - Tab Data Model
lib/tab.ts - Tab History
lib/tabHistory.ts - Tab Renderer
components/TabRenderer.tsx - Technique Popup
components/TechniquePopup.tsx - Playhead Timing
lib/usePlayhead.ts
Shared Domain and Audio
- Chord Detection
lib/chordDetection.ts - Microphone Input
lib/micInput.ts - Audio Playback
lib/useAudioPlayback.ts - Synth Worker
lib/synth/synthWorker.ts - Audio Worklet
public/synth-worklet.js - Tone Processing
lib/toneChain.ts - Glossary Data
lib/glossary.ts
Other components
- Learner
Connections 34
- Learner → Landing Page: opens
- Learner → Chord Library: explores chords
- Learner → Technique Glossary: learns notation
- Learner → Tab Import Page: imports tabs
- App Layout → Theme Controls: renders
app/layout.tsx - Chord Library → Progression Input: renders
app/acordes/page.tsx - Chord Library → Chord Library Data: looks up chords
app/acordes/page.tsx - Chord Library → Chord Diagram: renders
app/acordes/page.tsx - Chord Library → Difficulty Badge: shows difficulty
app/acordes/page.tsx - Chord Library → Chord Play-Along: starts play-along
app/acordes/page.tsx - Chord Diagram → Chord Library Data: reads chord
components/ChordDiagram.tsx - Chord Diagram → Fretboard View: renders on
components/ChordDiagram.tsx - Difficulty Badge → Transition Difficulty: displays result
components/TransitionBadge.tsx - Transition Difficulty → Chord Library Data: uses chord data
lib/transitionDifficulty.ts - Chord Play-Along → Microphone Input: opens microphone
lib/useChordPlayAlong.ts - Chord Play-Along → Chord Detection: analyzes frames
lib/useChordPlayAlong.ts - Chord Detection → Chord Library Data: ranks candidates
lib/chordDetection.ts - Technique Glossary → Glossary Detail: renders entries
app/glosario/page.tsx - Technique Glossary → Glossary Data: reads entries
app/glosario/page.tsx - Tab Import Page → Text Tab Parser: parses text
app/tablatura/page.tsx - Tab Import Page → Guitar Pro Import: imports files
app/tablatura/page.tsx - Tab Import Page → Tab History: saves history
app/tablatura/page.tsx - Tab Import Page → Tab Renderer: renders tab
app/tablatura/page.tsx - Text Tab Parser → Tab Data Model: produces model
lib/parseTab.ts - Guitar Pro Import → Tab Data Model: produces model
lib/importGuitarPro.ts - Tab Renderer → Tab Data Model: reads tab
components/TabRenderer.tsx - Tab Renderer → Technique Popup: shows techniques
components/TabRenderer.tsx - Technique Popup → Glossary Data: looks up symbols
components/TechniquePopup.tsx - Tab Import Page → Playhead Timing: controls playback
app/tablatura/page.tsx - Playhead Timing → Audio Playback: coordinates audio
lib/usePlayhead.ts - Playhead Timing → Tab Data Model: times tab beats
lib/usePlayhead.ts - Audio Playback → Synth Worker: sends commands
lib/useAudioPlayback.ts - Audio Playback → Tone Processing: configures tone
lib/useAudioPlayback.ts - Synth Worker → Audio Worklet: streams samples
lib/synth/synthWorker.ts