diff --git a/src/App.tsx b/src/App.tsx
index 95be657..443cabf 100644
--- a/src/App.tsx
+++ b/src/App.tsx
@@ -65,7 +65,7 @@ function App() {
for (const file of files) {
try {
- // Read the raw bytes first — needed for both hashing and decoding.
+ // Read the raw bytes first - needed for both hashing and decoding.
const arrayBuffer = await file.arrayBuffer();
// Hash and metadata extraction can run in parallel.
diff --git a/src/components/HelpModal.tsx b/src/components/HelpModal.tsx
index 9fb603d..4d716a9 100644
--- a/src/components/HelpModal.tsx
+++ b/src/components/HelpModal.tsx
@@ -50,83 +50,132 @@ export default function HelpModal({ onClose }: HelpModalProps) {
{/* Content */}
+ {/* Getting Started */}
Getting Started
- DJ AMBER is a powerful music mixing and sequencing tool. Use it to create, edit, and
- play custom music tracks with layered clips and effects.
+ DJ AMBER is a music mixing and sequencing tool for creating layered audio tracks and
+ smooth transitions.
+
+ - Upload or browse clips from the Music Library
+ - Drag clips onto the Timeline to begin building your track
+ - Arrange and adjust clips to shape your final mix
+
+ {/* Controls */}
- Music Library
+ Controls
- Browse and select audio clips from the Music Library panel on the left. Search for
- clips by name or category to quickly find what you need.
+ Use keyboard and navigation controls to work quickly and precisely.
+
+
+
Keyboard Shortcuts
+
+ -
+ Spacebar - Play or pause playback
+
+ -
+ Esc - Close the help modal or deselect a clip
+
+ -
+ Alt + drag - Overlap clips freely without pushing others
+
+ -
+ Delete / Backspace - Remove selected clip
+
+
+
+
+
+
Timeline Navigation
+
+ -
+ Scroll - Zoom in and out of the timeline
+
+ -
+ Shift + Scroll - Pan earlier or later
+
+ - Use horizontal trackpad gestures to pan the timeline
+
+
+ {/* Music Library */}
- Timeline
+ Music Library
- Drag clips from the Music Library onto the Timeline to add them to your project. Use
- the Timeline to arrange clips, set timing, and create your composition.
+ The Music Library lets you browse and add audio clips to your project.
+
+ - Search for clips by name or category
+ -
+ Click the + button to add a clip to your project
+
+ - Drag clips directly onto the Timeline to place them
+
+ {/* Timeline */}
- Now Playing
+ Timeline
- The Now Playing panel displays the currently selected track with playback controls,
- progress bar, and real-time lyrics display. Use the play and pause buttons to control
- playback.
+ The Timeline is where you arrange and shape your composition.
+
+ - Position clips to control timing and sequence
+ - Adjust clip edges to refine transitions
+ - Layer clips to create more complex soundscapes
+
+ {/* Set List */}
+ {/* Now Playing */}
+ {/* Tips & Tricks */}
Tips & Tricks
+
+ These tips can help you create smoother and more polished mixes.
+
- - Layer multiple clips to create rich soundscapes
- - Adjust timing and fades for smooth transitions
- - Use the progress bar to navigate through your project
+ - Layer clips to create richer sound combinations
+ - Fine-tune timing and fades for smoother transitions
+ - Use the progress bar to quickly navigate your project
-
- Dragging a clip on the timeline only edits the transition on its left side. Clips to
- the right ripple along to preserve their existing transitions. Hold Alt{' '}
- while dragging to override and let the clip overlap freely.
+ Dragging a clip edits the transition on its left side while preserving others. Hold{' '}
+ Alt to override and overlap freely.
- - Save your projects frequently to avoid losing work
diff --git a/src/components/NavBar.tsx b/src/components/NavBar.tsx
index 4e9b304..9cdd828 100644
--- a/src/components/NavBar.tsx
+++ b/src/components/NavBar.tsx
@@ -62,7 +62,7 @@ export default function NavBar({ masterVolume, onMasterVolumeChange }: NavBarPro
title="Help"
aria-label="Open help modal"
>
- ?
+ FAQ
diff --git a/src/styles/help-modal.css b/src/styles/help-modal.css
index 9017721..1178e3b 100644
--- a/src/styles/help-modal.css
+++ b/src/styles/help-modal.css
@@ -206,3 +206,16 @@ kbd {
.help-modal-button:active {
transform: scale(0.98);
}
+
+.help-subsection {
+ display: flex;
+ flex-direction: column;
+ gap: var(--space-2);
+}
+
+.help-subsection-title {
+ font-size: var(--fs-md);
+ font-weight: var(--fw-semibold);
+ color: #ffffff;
+ margin: 0;
+}