Skip to content

Latest commit

 

History

8 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Hajji Helper

A trilingual communicative flashcard web app built for Hajj-Umrah pilgrims. Cards appear in Bangla, Arabic, and English — tap to expand, scroll through phrases that hajjis actually need on the ground.

Works offline, installs like a native app, and pulls flashcards from a Google Sheet so organizers/guerdians can update content without touching any code.


Quick Setup

You'll need a GitHub account and a Google Sheet.

1. Fork this repo

Click Fork on the top-right of this page. Keep the default name or rename it — doesn't matter.

2. Enable GitHub Pages

Go to your fork → Settings tab → Pages(On the sidebar) → set Source to main branch, root folder → Save. Wait a minute or two. Your site goes live at:

https://YOUR-USERNAME.github.io/Hajji-Helper/

3. Create a Google Sheet

Make a new sheet with these column headers in Row 1:

| Bangla | Arabic | English |   <--- Row 1 must be exactly this
|--------|--------|---------|
| আমি হারিয়ে গেছি | أنا تائر | I am lost |

Then publish it: File → Share → Publish to web → Publish.

Note: Don't close the browser tab yet

4. Connect your sheet

Open your live site. At the bottom, paste your Spreadsheet ID (the string between /d/ and /edit in the sheet URL) and hit Save.

Done. Share the link the app gives you — pilgrims open it and see your cards immediately.


Usage

  • Browse cards — tap to expand/collapse
  • Install on phone — Android/Chrome: menu → "Add to Home Screen". iPhone/Safari: Share → "Add to Home Screen"
  • Works offline — after the first visit, no internet needed
  • Cards auto-update — edit your Google Sheet and changes show up within about a minute (internet connection required)
  • Add essential information — Add hotel information, muallim contact, medical information and other essential details to your sheet

License

This project is released under the MIT License. Do whatever you want with it — just don't hold the author liable.

About

Communication helper app for hajj-umrah pilgrims.

Resources

Stars

4 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages