🌸 Flocus V2

Flocus V2 is a modern productivity and focus-tracking web app built with React, Vite, and TailwindCSS.
It provides a minimal yet gamified way to manage tasks, track focus sessions, and visualize your productivity streaks — all from your browser.

(Demo here: https://flocus-v2.onrender.com/)

---

🚀 Features

• 🕒 Focus Sessions: Start and complete "work" or "break" sessions with XP and coin rewards.
• 🧠 Stats Tracking: View total sessions, focus minutes, and streak data.
• 🧾 Task Management: Create to-dos with categories, due dates, and priorities.
• 🎨 Customizable Themes: Light, Dark, Cyberpunk, Nature, and Minimal modes.
• 💾 Local Memory Backend: Uses in-memory storage for testing (no real database).

---

🏗️ Tech Stack

Layer	Technology
Frontend	React + TypeScript + Vite
Styling	TailwindCSS
Validation	Zod
Backend (Mock)	Express (in-memory storage)
Database (optional)	Drizzle ORM (schema only)

---

📂 Project Structure

FLOCUS-V2/
├── attached_assets/   # App images and icons
├── client/            # Frontend source code
│   ├── public/        # Static files
│   └── src/           # React components and hooks
├── server/            # Express backend (in-memory)
├── shared/            # Shared schemas and types
├── vite.config.ts     # Vite configuration
├── tailwind.config.ts # TailwindCSS setup
├── tsconfig.json      # TypeScript configuration
└── package.json

🧩 How It Works

Backend

The backend (/server) is a lightweight Express server that simulates data persistence in memory using JavaScript Map() objects:

this.profiles = new Map();
this.sessions = new Map();

No real database is used — the data resets when the server restarts.

Frontend

The frontend (/client) is built with Vite and React. It fetches mock API routes from the local Express server (during development) or can be configured to use browser storage for persistence when deployed.

🧰 Installation

1. Clone the repository

   git clone https://github.com/Xtrios09/Flocus-V2.git
   cd Flocus-V2

2. Install dependencies

   npm install

3. Run locally

   npm run dev

   By default, the frontend runs on http://localhost:5000.

⚙️ Environment Variables

Variable	Description	Example
PORT	Express server port	5000
VITE_API_URL	API base URL (for frontend)	https://your-backend-url.com

---

📜 License

This project is licensed under the MIT License.

---

❤️ Credits

Developed by Abhijeet Prabhakar. Built with creativity, caffeine, and focus ☕✨