Skip to content

SameeraaGKan/BloomDesk

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

33 Commits
 
 
 
 
 
 
 
 

Repository files navigation

🌿 BloomDesk

A cozy garden-themed productivity app where every focus session waters your plant. Built with React + Vite.

Live: bloom-desk-ruby.vercel.app

BloomDesk Vite Groq Deployed on Vercel

What it does

Focus Timer — Pomodoro-style timer with customizable session lengths. Complete a session and your plant gets watered.

Living Plant — Your plant grows through 6 stages (Seed → Sprout → Leafy → Potted → Flowering → Full Bloom) as you accumulate focus sessions. Each stage has a glow effect and progress bar to the next stage.

Pet Garden — Unlock companion pets (Froggo, Mochi, Bun Bun, Pebble, Ember) as milestones hit. Pets animate while you're in a focus session.

Stats — Session count, total focus minutes, water drops collected, and a streak toward your next pet unlock.

Bloom Buddy — An AI wellness companion (powered by Groq) that gives personalized break suggestions after each session and responds to freeform questions. Full multi-turn chat with conversation memory.

Stack

  • React 19 + Vite 8
  • Groq SDK (llama-3.1-8b-instant) for the AI companion
  • Pure CSS glassmorphism — no UI library
  • localStorage for persistence across sessions

Getting started

git clone https://github.com/SameeraaGKan/BloomDesk.git
cd BloomDesk/bloomdesk
npm install

Create a .env file in the bloomdesk/ directory:

VITE_GROQ_API_KEY=your_groq_key_here

Get a free API key at console.groq.com. The app works without it — Bloom Buddy will just be dormant.

npm run dev

Open http://localhost:5173.

Project structure

bloomdesk/
├── src/
│   ├── components/
│   │   ├── Timer.jsx          # Focus timer with session controls
│   │   ├── Plant.jsx          # Growing plant with stage progression
│   │   ├── PetGarden.jsx      # Unlockable companion pets
│   │   ├── Stats.jsx          # Session statistics
│   │   └── WellnessAgent.jsx  # Bloom Buddy AI chat
│   ├── App.jsx                # Root state, session logic
│   ├── App.css                # All layout and component styles
│   └── index.css              # Global tokens and body background
└── .env                       # VITE_GROQ_API_KEY (not committed)

About

A cozy garden-themed productivity app where every focus session waters your plant. Built with React + Vite.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors