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/
π§ 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