How dannycancode/ezzytracker works
Project Type and Purpose
• EzzyTracker is a React + TypeScript SPA bundled with Vite, styled with Tailwind CSS.
• It provides task management (Pomodoro timer, tags, priorities, due dates, stats) entirely in the browser, with persistent state in localStorage and desktop notifications via the Web Notification API.
• There is one external link/integration (EzzyFit).
File Structure
• Top-level configs (eslint.config.js, tsconfig*.json, tailwind.config.js, postcss.config.js, vite.config.ts) indicate a modern front-end toolchain.
• index.html, index–*.js, index-*.css are build outputs.
• No “backend” or “api” directory → frontend-only.
Core Components
a. Development Environment
– IDE/Code (src/ directory implied)
– Vite development server (npm run dev)
– Build pipeline (Vite → output: index.html + CSS + JS)
b. Hosting & Deployment
– Static host / CDN (e.g., Netlify) serving the built assets
c. Browser Runtime
– React Application (UI layer)
– Tailwind CSS (styling)
– State Management (React state/hooks)
– Persistence Layer (window.localStorage)
– Browser APIs:
• Notification API for Pomodoro alerts
• Responsive layout (CSS + media queries)
d. External Service
– EzzyFit (external link/integration)
Relationships & Data Flow
• Developer → commits to GitHub → CI/CD → deploys to Netlify
• Client’s browser requests index.html, CSS, JS from CDN
• React app boots in browser → reads/writes localStorage
• User interacts with UI → React state updates → persisted in localStorage
• Pomodoro timer expiry → triggers Notification API
• “EzzyFit” link → opens external EzzyFit app in new tab
Architectural Patterns & Design Principles
• SPA (Client-side rendering)
• Static hosting (no server-side logic)
• Unidirectional data flow (React hooks/state → view → events → state)
• Progressive enhancement (works offline, localStorage)
• Modular CSS (Tailwind utility classes)
Technologies & Frameworks to Call Out
• React (component architecture)
• TypeScript (type safety)
• Vite (ESM dev server + build)
• Tailwind CSS (utility-first styling)
• Browser APIs: localStorage, Notifications
• Netlify (static hosting / CDN)