🌟 Mattioli.OS

Master Your Discipline. Own Your Data. Gamify Your Growth.

"We don't rise to the level of our goals. We fall to the level of our systems." — James Clear

🏁 Quick Start • ✨ Features • 📚 Documentation • 🧠 Philosophy

---

⚡️ Quick Start

Get up and running in seconds.

# 1. Clone the repo
git clone https://github.com/simo-hue/habit-tracker.git

# 2. Enter the directory
cd habit-tracker

# 3. Install dependencies
npm install

# 4. Start the dev server
npm run dev

Note: For full backend functionality, run the provided schema.sql in your Supabase project. See the Technical Setup Guide for details.

---

💎 Key Features

Why choose Mattioli.OS over Notion, Todoist, or expensive SaaS apps?

Feature	🌟 Mattioli.OS	📝 Notion/Generic	💰 Paid SaaS
Data Ownership	✅ 100% Yours (Local/Supabase)	❌ Cloud Only	❌ Vendor Locked
Cost	✅ Free Forever	⚠️ Monthly Sub	❌ $$$ / Month
Offline First	✅ Localhost Capable	⚠️ Limited	❌ No

🔥 Core Modules

📅 Daily Habits & Tracking (Click to Collapse)

Track your daily progress with granular precision. Switch between monthly and weekly views to analyze your consistency.

Monthly View	Weekly Breakdown

Detailed Statistics:

🎯 Macro Goals & Long-term Vision (Click to Expand)

Align your daily actions with your life's biggest ambitions.

Single Year Focus	Multi-Year Trends

---

📚 Documentation Hub

We have crafted distinct paths for every type of user.

🇮🇹 Italian Docs	🇺🇸 English Docs
Manuale Utente Per chi vuole solo usare l'app.	User Manual For those who just want to use the app.
Guida Tecnica Setup locale e deploy.	Technical Guide Local setup and deployment.

🧠 For Engineers

Check out the Technical Deep Dive for:

• Architecture Diagrams (Mermaid.js)
• State Management Philosophy (React Query)
• Supabase Security Rules (RLS) explanations.

---

🧘 Philosophy

This tool is Opinionated. It assumes:

1. Friction is the enemy. Tracking must be instant.
2. Privacy is non-negotiable. Your habit data is your business.
3. Aesthetics matter. If an app looks bad, you won't use it.

---

🤝 Contributing

We love contributions! Please read our CONTRIBUTING.md first.

1. Fork it (https://github.com/yourname/habit-tracker/fork)
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

---

Made with ❤️, ☕, and React | Mattioli Simone.