πŸš€ AB's Tracker Deployment Playbook

From Idea to Live on the Internet

1
πŸ’‘ Ideation & Design
Define what you want to track and how it should look
βœ“ Identify what to track
Example: Manga arcs, episodes, tasks, habits, etc.
βœ“ Decide on data structure
What info do you need? (titles, progress, descriptions, etc.)
βœ“ Choose visual style
Colors, theme, layout - make it yours!
↓
2
⚑ Build with Claude (C)
Collaborate with C to create your tracker
βœ“ Describe your vision to C
Be specific about features, look, and functionality
βœ“ Review the HTML file C creates
Download and save it somewhere organized
βœ“ Test locally
Open the HTML file in Chrome to see how it works
βœ“ Request tweaks if needed
Colors, features, layout - iterate until perfect!
↓
3
☁️ Add Firebase Integration
Make it sync across all your devices
βœ“ Get your Firebase config
From Firebase Console β†’ Your project β†’ Settings β†’ Config code
βœ“ Ask C to add Firebase
Share config, C updates the HTML with cloud sync
βœ“ Test the Firebase version locally
Open in Chrome, check that it connects to Firebase
↓
4
πŸ“ Prepare Project Folder
Set up your deployment structure
βœ“ Navigate to your projects folder
cd ~/Documents/AI-Projects
βœ“ Create project folder
mkdir your-tracker-name
βœ“ Enter the folder
cd your-tracker-name
βœ“ Initialize Firebase Hosting
firebase init hosting
↓
5
🎯 Configure Firebase Init
Answer the setup questions correctly
Question 1: Select an option
β†’ Choose "Use an existing project"
Question 2: Select project
β†’ Choose "ab-trackers" (or your Firebase project name)
Question 3: Public directory
β†’ Type "public" and press Enter
Question 4: Single-page app
β†’ Type "n" (no) and press Enter
Question 5: GitHub deploys
β†’ Type "n" (no) and press Enter
↓
6
πŸ“ Add Your Files
Put your tracker in the right place
βœ“ Navigate to public folder
In Finder: Go to your-tracker-name/public/
βœ“ Delete Firebase's default index.html
Remove the placeholder welcome page
βœ“ Copy your tracker HTML file
Put your Firebase-enabled HTML in the public folder
βœ“ Rename it to index.html
This makes it the main page of your site
↓
7
πŸš€ Deploy to Firebase
Push your tracker live to the internet!
βœ“ Make sure you're in project root
cd ~/Documents/AI-Projects/your-tracker-name
βœ“ Run deploy command
firebase deploy
βœ“ Wait for completion
Watch for "Deploy complete!" message
βœ“ Copy your Hosting URL
Looks like: https://ab-trackers.web.app
↓
8
πŸŽ‰ Test & Celebrate
Verify it works everywhere!
βœ“ Open URL on Mac
Test in Chrome - make sure everything loads
βœ“ Open URL on iPhone
Check that it looks good and data syncs
βœ“ Test cross-device sync
Update on Mac, refresh on iPhone - should sync!
βœ“ Do your victory dance! πŸ•ΊπŸ’ƒ
You've earned it!
⚑ Quick Command Reference
Navigate to Projects Folder:
cd ~/Documents/AI-Projects
Create New Tracker Folder:
mkdir tracker-name
cd tracker-name
Initialize Firebase (do this ONCE per tracker):
firebase init hosting
Check What's in Public Folder:
cd public
ls
Deploy to Internet:
cd ~/Documents/AI-Projects/tracker-name
firebase deploy
Redeploy After Changes:
# Make your changes in public/index.html
firebase deploy
πŸ’‘ Pro Tip:
After making changes to your HTML file, you MUST run firebase deploy again to see them online. Your local file and the deployed version are separate!
πŸ’‘ Pro Tip:
All your trackers can use the SAME Firebase project (ab-trackers). You just need different folders for each one. They'll all share the same Firebase database!
πŸ’‘ Pro Tip:
Keep your Desktop clean! Always work in ~/Documents/AI-Projects/
βœ… Pre-Deployment Checklist

Run through this before every deploy to catch mistakes early!

πŸ”§ Common Issues & Fixes
Issue: Seeing Firebase welcome page instead of my tracker
Fix: You didn't replace the default index.html
cd public
rm index.html
mv YourTracker.html index.html
cd ..
firebase deploy
Issue: "command not found: firebase"
Fix: Firebase CLI not installed
sudo npm install -g firebase-tools
Issue: Changes not showing online
Fix: Forgot to redeploy after editing
firebase deploy
(Then do a hard refresh in browser: Cmd+Shift+R)
Issue: Data not syncing between devices
Fix: Check Firebase config in HTML - make sure it matches your project
Or check Firestore rules in Firebase Console