-
Notifications
You must be signed in to change notification settings - Fork 0
FAQ
Common questions about StepSyncAI answered.
A: No! StepSyncAI works without any account, login, or personal information. Just visit the site and start tracking.
A: Yes, completely free. No premium tiers, no subscriptions, no ads. Open source and always will be.
A: Absolutely! StepSyncAI is mobile-optimized and installable as a PWA (Progressive Web App) on iOS and Android.
A: Yes! After the first visit, the service worker caches the app so you can track data even without internet.
A: 100% in your browser's localStorage on YOUR device. It never leaves your device or gets sent to any server.
A: No. We literally cannot access your data. There's no backend server collecting anything. It's all local.
A: Your data will be deleted when you close the browser tab/window. Use normal browsing mode for persistent data.
A: localStorage is automatically encrypted by your browser if your device has full-disk encryption (FileVault on Mac, BitLocker on Windows). For extra security, we recommend enabling device encryption.
A: If your device is locked with a password/PIN/biometric, they can't access your browser data. Use a strong lock screen password.
A: Not yet. Currently data is local only. Cloud sync is planned as an optional feature you can enable.
A: Not yet, but we're working on JSON import. You can manually export from other apps and import to StepSyncAI (coming soon).
A: Our database includes 150+ medications and 65+ dangerous interaction pairs, validated against medical literature. However, it's not a substitute for professional medical advice. Always consult your doctor or pharmacist.
A: Not currently. StepSyncAI is designed for individual use. Multi-user support is on the roadmap.
A: Not yet. Wearable integration is planned for future releases.
A:
- Go to Dashboard
- Click "Export Data"
- Save the JSON file to your computer/cloud storage
- Re-import later (feature coming soon)
A:
- Go to Dashboard
- Click "Sign Out"
- Confirm deletion
- All data is permanently erased
WARNING: This cannot be undone. Export your data first if you need a backup.
A: No. Once deleted (via Sign Out), data cannot be recovered. That's by design—privacy means true deletion.
A: Browser localStorage typically allows 5-10MB. That's enough for years of daily tracking for most users.
A: You'll get an error when trying to save new data. You can:
- Delete old entries manually
- Export and clear data
- Upgrade to IndexedDB (planned) for unlimited storage
A: StepSyncAI works on:
- ✅ Chrome 90+ (recommended)
- ✅ Edge 90+
- ✅ Firefox 88+
- ✅ Safari 14+
- ✅ Opera 76+
- ✅ Brave (Chromium-based)
Basically any modern browser with localStorage and service worker support.
A: Yes! Safari on iOS 14+ is fully supported. Install it as a PWA via Share → Add to Home Screen.
A: Yes! Chrome on Android is fully supported. Install via the "Add to Home screen" prompt.
A: To keep the app lightweight and leverage browser caching. The CDN (jsDelivr) is one of the most reliable in the world.
A: Absolutely! It's open source. Clone the repo and host it anywhere:
git clone https://github.com/Isaloum/StepSyncAI.git
cd StepSyncAI
# Serve docs/ folder with any web server
python -m http.server 8000 # Python
# OR
npx http-server docs/ # Node.jsA: The app auto-updates when you reload. The service worker checks for new versions. Or:
- Clear browser cache
- Reload the page
- Latest version will load
A: Initial load: ~260KB (HTML/CSS/JS + Chart.js). Subsequent loads: <5KB (cached).
A: The app parses your dosage (e.g., "1000 IU") and checks:
- Universal limits (>50,000mg is dangerous for any medication)
- Specific drug limits (e.g., Vitamin D >10,000 IU needs doctor approval)
- Unit normalization (converts µg to mcg, etc.)
A: You can still add it! The app will use universal safety checks (>50,000mg = critical). For specific validation, request addition with medical sources.
A: Not yet. This feature requires push notifications, which are planned but not yet implemented.
A:
- Go to Medication tab
- Find your medication card
- Click "Mark Taken"
- Button turns green (✅ Taken)
A: No, they don't auto-reset yet. You need to manually unmark them or add new instances. Auto-reset is planned.
A:
- 25% from Mood (mood/10 × 25)
- 25% from Sleep (hours/8 × 25, capped at 10 hours)
- 25% from Exercise (minutes/30 × 25, capped at 60 minutes)
- 25% from Medication Adherence (taken/total × 25)
Total: 0-100 score
A: The score requires data in all four categories. If you're not tracking exercise or medications, those contribute 0 points. Focus on the categories that matter most to you.
A: Not yet, but it's on the roadmap. We want to let users prioritize what matters most to them.
A: You need at least 2 days of data to see trends. Keep logging for a few days and the chart will populate.
A: Not yet. Currently shows the last 7 days. Customizable ranges (30 days, 90 days, all-time) are planned.
A:
- 🔵 Blue: Mood
- 🟣 Purple: Sleep
- 🟢 Green: Exercise
- 🟡 Orange: Medication Adherence
A: Not yet, but you can screenshot. Chart image export is planned.
A: Research shows bottom navigation is easier to reach with thumbs on large phones. It's a UX best practice for mobile-first apps.
A: Not yet, but swipe navigation is planned for the next version.
A: To ensure you see the full content of each tab. This prevents confusion when switching from a long scrolled section.
A: Yes! StepSyncAI is open source. Read the Contributing Guide to get started.
A: Open an issue on GitHub with:
- Bug description
- Steps to reproduce
- Browser and OS
- Screenshots (if applicable)
A: Absolutely! Open a feature request or join Discussions.
A:
- ⭐ Star the repo
- 🐛 Report bugs
- 💡 Suggest features
- 🔧 Contribute code
- 📣 Share with friends/family
- 💬 Answer questions in Discussions
A: No. It's a personal wellness tracking tool, not a medical device. It's not FDA approved or intended to diagnose, treat, or prevent any medical condition.
A: No. Only a licensed healthcare professional can diagnose mental health conditions. StepSyncAI can help you track patterns to discuss with your doctor.
A: Absolutely not! Never change medications without consulting your doctor. The app's warnings are informational only.
A: Yes! Export your data (JSON format) and:
- Email it (use secure email)
- Print it out
- Show graphs during appointment
- Upload to patient portal (if supported)
A: StepSyncAI is NOT for emergencies. If you're in crisis:
- 🇺🇸 US: Call 988 (Suicide & Crisis Lifeline)
- 🆘 Emergency: Call 911 or your local emergency number
- 🌍 International: Find crisis resources
A:
- Check internet connection (required for first load)
- Try a different browser
- Clear browser cache and reload
- Disable browser extensions
- Check browser console for errors (F12 → Console)
A:
- If you exported recently: Import the JSON file (when feature is ready)
- If you didn't export: Data is likely unrecoverable
- Check if you're in the same browser (Chrome vs Firefox have separate localStorage)
- Check if you're in private browsing mode (data auto-deletes)
A:
- Refresh the page
- Log new data in all four categories
- Check browser console for errors
- Try clearing cache and reloading
A:
- Ensure you have Chart.js loaded (check for CDN errors)
- Log at least 2 days of data
- Refresh the page
- Check browser console for errors
- Try disabling ad blockers (they might block CDN)
A: "Step" refers to steps toward better health, "Sync" refers to synchronizing mind and body wellness, and "AI" is planned for future machine learning insights (not yet implemented).
A: Yes! Dark mode is the default. Click the 🌙/☀️ button in the top-right to toggle.
A: Not yet. Currently English only. Internationalization (i18n) is on the roadmap.
A: Yes. StepSyncAI is open source (MIT License) and will always have a free, full-featured version. No ads, no premium tiers.
- 💬 Ask in Discussions - Community support
- 📖 Read the Wiki - Full documentation
- 🐛 Report an Issue - Bugs or feature requests