RTSDA/Adventist-Hymnarium-Web
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
PWA Adventist Hymnarium
5 commits 1 branch 0 tags 325 KiB
Find a file
Exact
Benjamin Slingo dc8104ebb3 Fix responsive readings search by number and add debounced search 
- Fix search by number for responsive readings (was passing number as text query)
- Add 500ms debounce to search inputs to prevent flickering during typing
- Create shared useDebounce hook for consistent debouncing across pages
2025-12-04 16:41:47 -05:00
public Add PWA icons and make app installable 2025-12-03 00:44:55 -05:00
src Fix responsive readings search by number and add debounced search 2025-12-04 16:41:47 -05:00
.gitignore Add PWA icons and make app installable 2025-12-03 00:44:55 -05:00
index.html Add PWA icons and make app installable 2025-12-03 00:44:55 -05:00
LICENSE Redesign UI with elegant theme and add global audio player 2025-12-02 19:07:08 -05:00
package-lock.json Initial commit: Adventist Hymnarium Web 2025-12-02 16:40:28 -05:00
package.json Initial commit: Adventist Hymnarium Web 2025-12-02 16:40:28 -05:00
README.md Redesign UI with elegant theme and add global audio player 2025-12-02 19:07:08 -05:00
tsconfig.app.json Initial commit: Adventist Hymnarium Web 2025-12-02 16:40:28 -05:00
tsconfig.json Initial commit: Adventist Hymnarium Web 2025-12-02 16:40:28 -05:00
tsconfig.node.json Initial commit: Adventist Hymnarium Web 2025-12-02 16:40:28 -05:00
vite.config.ts Add PWA icons and make app installable 2025-12-03 00:44:55 -05:00

README.md

Adventist Hymnarium Web

A modern, elegant web application for browsing and listening to Seventh-day Adventist hymns. Built as a Progressive Web App (PWA) for seamless use on desktop and mobile devices.

Features

  • Two Hymnals: Browse the SDA Hymnal (1985) and Christ in Song (1941)
  • Audio Playback: Listen to hymn melodies with a persistent global audio player
  • Sheet Music: View sheet music for hymns (where available)
  • Responsive Readings: Scripture readings 696-920 from the SDA Hymnal
  • Favorites: Save your favorite hymns for quick access
  • Theme Browsing: Explore hymns organized by theme
  • Search: Find hymns by title, lyrics, or number
  • Dark Mode: Automatic dark mode support
  • PWA: Install as an app on Android, iOS, or desktop

Tech Stack

Getting Started

Prerequisites

  • Node.js 18+
  • npm or pnpm

Installation

# Clone the repository
git clone https://github.com/your-username/adventist-hymnarium-web.git
cd adventist-hymnarium-web

# Install dependencies
npm install

# Start development server
npm run dev

Building for Production

npm run build

The built files will be in the dist directory.

Project Structure

src/
├── components/       # Reusable UI components
├── pages/            # Route pages
├── stores/           # Global state (audio, favorites, hymnal data)
├── wasm/             # WebAssembly bindings
├── App.tsx           # Root component with routing
└── index.css         # Global styles and design system

License

This project is open source and available under the MIT License.