User Guide

Your complete guide to habit tracking

Back to Home

What ChainIt is

Tap habit tracker with instant visual feedback and a clean, glassy UI.

Stay on track with contribution grid and insightful analytics that make your streaks shine.

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.

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.
  • • Includes all habit data and settings.

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.

Tips

  • Daily routine: Use the Today toggle for quick daily tracking, pencil for any edits or backfill.
  • Stay consistent: Set a specific time each day to check your habits—morning or evening works best.
  • Backup regularly: Export your data monthly or before major phone updates to keep your progress safe.
  • Start small: Begin with 1-2 habits, then gradually add more as you build momentum.
  • Check analytics: Review your weekly/monthly progress to stay motivated and spot patterns.

FAQ

Is my data private?

Yes! All your data stays on your device. Nothing is sent to external servers - it's completely private.

How do I backup my habits?

Go to Settings and use Export to create a backup file. Import it on any device to restore your data.

Can I use this offline?

Absolutely! ChainIt works completely offline. Your data is stored locally on your device.

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.
  • • Keep the app updated for the best experience and latest features.