abbel-dawit/LOYAL

Customers earn and redeem points with just their phone number — no app, no card, no QR. Automated SMS goes out in Amharic & English over Ethiopian gateways (AfroMessage, GeezSMS, Ethio Telecom). Loyalty tiers follow the coffee ceremony: Abol → Tona → Baraka. # Loyal · ታማኝ **Loyalty in a tap — phone-number loyalty for Ethiopian small business.** Customers earn and redeem points with just their phone number — no app, no card, no QR. Automated SMS goes out in Amharic & English over Ethiopian gateways (AfroMessage, GeezSMS, Ethio Telecom). Loyalty tiers follow the coffee ceremony: **Abol → Tona → Baraka**. This is a static site — pure HTML/CSS/JS, no build step, no dependencies. It runs anywhere. ## Pages | File | What it is | |------|------------| | `index.html` | Marketing landing page (features, tiers, pricing, FAQ) | | `app.html` | The business tool — look up customers, earn/redeem points, send SMS | | `balance.html` | Customer-facing page to check a points balance by phone number | The theme (light/dark) is shared across all three pages and remembered between visits. > **Note:** All customers, points and SMS are sample data held in the browser. To go live you add a small backend that holds your SMS gateway API key and stores customers — see *Going live* below. --- ## Deploy to GitHub Pages 1. **Create a repo** on GitHub (e.g. `loyal`). 2. **Upload these files** to the root of the repo: `index.html`, `app.html`, `balance.html`, `README.md`, and `.nojekyll`. - On github.com: *Add file → Upload files → drag them in → Commit.* - Or with git: ```bash git init git add . git commit -m "Loyal site" git branch -M main git remote add origin github.com git push -u origin main ``` 3. **Turn on Pages:** repo **Settings → Pages → Build and deployment → Source: Deploy from a branch → Branch: `main` / `/ (root)` → Save.** 4. Wait ~1 minute. Your site is live at: ``` username.github.io ``` The landing page loads first; **Open the app** goes to `app.html`. That's it. The `.nojekyll` file tells GitHub Pages to serve the files as-is. ### Custom domain (optional) In **Settings → Pages → Custom domain**, add e.g. `loyal.et`, then point a `CNAME` DNS record at `USERNAME.github.io`. --- …