Math Lab - GitHub Pages Deployment Guide

מעבדת המתמטיקה - מדריך פריסה ל-GitHub Pages

Quick Start - 5 Minutes to Live Site! 🚀

Step 1: Create GitHub Account (if you don't have one)

1. Go to https://github.com
2. Click "Sign up"
3. Follow the prompts

Step 2: Create a New Repository

1. Click the "+" button in top right → "New repository"
2. Repository name: subtraction-lab (or any name you like)
3. Description: "Interactive subtraction learning app for kids"
4. Select "Public"
5. ✅ Check "Add a README file"
6. Click "Create repository"

Step 3: Upload the File

1. In your new repository, click "Add file" → "Upload files"
2. Drag and drop the index.html file from this folder
3. Scroll down and click "Commit changes"

Step 4: Enable GitHub Pages

1. In your repository, click "Settings" (top menu)
2. Scroll down to "Pages" in the left sidebar
3. Under "Source", select:
   • Branch: main
   • Folder: / (root)
4. Click "Save"
5. Wait 1-2 minutes for deployment

Step 5: Get Your Live URL! 🎉

Your app is now live at:

https://presmann.github.io/subtraction-lab

For example, if your GitHub username is noam123, your URL will be:

https://noam123.github.io/subtraction-lab

---

Using on Android Tablet 📱

Method 1: Bookmark It

1. Open the GitHub Pages URL in Chrome/Firefox
2. Tap the ⋮ menu → "Add to Home screen"
3. Name it "מעבדת המתמטיקה" or "Math Lab"
4. Now you have an app icon on your home screen!

Method 2: Share the Link

Send the link to your tablet via:

• WhatsApp
• Email
• Google Keep
• Telegram

---

Updating the App

To make changes later:

1. Go to your repository on GitHub
2. Click on index.html
3. Click the pencil icon (✏️) to edit
4. Make your changes
5. Scroll down and click "Commit changes"
6. Wait 1-2 minutes for changes to deploy

---

Troubleshooting

"Page not found" error?

• Wait 2-3 minutes after enabling GitHub Pages
• Make sure the file is named exactly index.html (lowercase)
• Check that Pages is enabled in Settings

App not updating after changes?

• Clear browser cache (Ctrl+Shift+Del or Cmd+Shift+Del)
• Wait a few minutes for GitHub to rebuild
• Try incognito/private browsing mode

Need help?

• GitHub Pages documentation: https://pages.github.com
• Or ask for help with your specific error message

---

Features of Your App

✅ Three learning methods:

• Number Line (ציר מספרים) - Visual stepping
• Apples (תפוחים) - Delete or count mode
• Fingers (אצבעות) - Mark or count mode

✅ Bilingual Hebrew/English interface ✅ Interactive graphics with SVG animations ✅ Works offline after first load ✅ Responsive design for tablets and phones ✅ No installation required

---

Advanced: Custom Domain (Optional)

Want a custom URL like math.yourdomain.com?

1. Buy a domain from any registrar
2. In your repo Settings → Pages → Custom domain
3. Enter your domain
4. Follow GitHub's DNS configuration guide

---

License

Feel free to modify and use this app for educational purposes.

Created with ❤️ for Hadas and Yaara