What ChainIt is
Tap‑first habit tracker with instant visual feedback and a clean, glassy UI.
GitHub‑style contribution grid and weekly stats to make streaks obvious.
Private by design: data stays on your device; import/export when you want.
Home
Habit cards
- •Title + description with compact weekly stats.
- •Pencil icon (edit): opens the date editor instantly. Only the pencil opens the editor to prevent accidental opens while scrolling.
- •Today toggle: tap to mark/unmark today. UI updates instantly; save happens in the background.
- •Haptics + press‑scale on interactive elements for tactile feedback without lag.
Contribution grid
- •Shows the last 365 days (like GitHub).
- •Read‑only on the Home screen (no accidental opens during scroll).
- •Weekly progress bar with percent and counts.
Floating + button
- •Opens Create Habit instantly (focused on the title input).
- •Subtle glow and blur for a glassy look.
Create Habit
- •Open: tap the + button (immediate focus on the title).
- •Fields: Title (required), Description (optional), Color.
- •Submit: creates the habit and closes quickly; a small spinner shows briefly.
- •Close: tap Cancel or backdrop. Fields reset after close for snappy UI.
Notes: Optimized for fast open/close (requestAnimationFrame focus, hardware‑accelerated modal). Keyboard padding ensures inputs aren't obscured.
Edit Habit & Dates
Open editor
Tap the pencil on a habit card.
Header
Habit icon/color, title, description.
Date section
- •"Today" and "Yesterday" quick actions.
- •Full calendar: tap any date to toggle.
Actions
- •Share: open "Share Habit" view (choose color, export a nicely formatted card).
- •Delete: confirmation prompt.
- •Edit habit details: open a dedicated edit dialog.
Close
- •Close button shows a tiny spinner and blur briefly for feedback.
- •Back/hardware close commits changes silently without the spinner.
Import / Export
Open Settings: header cog icon.
Export
- •Share a JSON file or save locally.
- •Suggested file names provided.
Import
- •Pick a JSON file and import.
- •Duplicates are skipped gracefully.
- •UI updates immediately after import.
Privacy: Everything is on‑device. Use import/export for backups or device migration.
Share Habit
- •Customize & share: change color, preview the card, share via your device share sheet.
- •Spinner: shows while rendering/sharing the view.
Performance & UX
- •Instant UI: tap → UI updates immediately; saves run in the background (debounced).
- •Scroll‑safe editing: only the pencil opens the editor; grid taps on Home don't open modals.
- •Haptics + press‑scale: feedback is scheduled to avoid blocking the main thread.
- •Loading screen: remains until the home UI is fully ready (post‑layout) to avoid flashes.
Tips
- •Use the Pencil for any edits; use the Today toggle for fastest daily tracking.
- •Import/Export occasionally as a backup.
- •For the smoothest feel, test on a release build (dev logging can add overhead).
FAQ
Why doesn't the grid open the editor on Home?
To prevent accidental opens during scroll. Use the pencil for edits.
Why do actions feel instant even on slow devices?
UI updates first, persistence runs in the background with a short debounce.
Where's my data?
On your device. Use import/export for backups or transfer.
The editor shows a tiny spinner on close—why?
It's a very brief visual cue while committing all changes and closing without lag.
Known behaviors
- •Dev mode performance can feel slightly slower (expected for React Native). Release builds are very smooth.
- •Very large habit lists may require device‑level optimizations; lists are already tuned (windowing, clipping, low re‑rendering).
Support
- •Export your habits (for backup) before major changes.
- •For issues: describe the device, OS, and steps to reproduce; include whether it's a dev or release build.