🌱 A daily goal tracker where every task you complete grows a plant — your day, as a garden.
Built from a single sentence with Kiro Specs:
Build a web app that turns my daily goal list into a garden that blooms as I check things off.
Bloomlist turns your daily to-do list into a visual garden. Add tasks, and each one becomes a seed. Check it off, and watch it bloom through four growth stages. Complete everything and get a confetti celebration. Each day starts fresh.
npm install
npm run devOpen http://localhost:5173 in your browser.
To deploy your own instance to AWS (S3 + CloudFront), you'll need to configure your domain and AWS credentials first. See docs/DEPLOYMENT.md for the full setup guide.
| Command | Description |
|---|---|
npm run dev |
Start dev server |
npm run build |
Type-check and build for production |
npm run preview |
Preview production build |
npm run test |
Run all tests once |
npm run test:watch |
Run tests in watch mode |
npm run deploy |
Build and deploy to AWS (requires setup — see Deployment) |
- Daily tasks — Create up to 20 tasks per day with validation
- Visual garden — Each task maps to a plant that grows when completed
- Growth animation — Plants animate through seed → sprout → budding → blooming
- Celebration — Confetti effect when all tasks are done
- Persistence — State saved to localStorage, survives page refresh
- Daily reset — Fresh garden every day at midnight
- Responsive — Side-by-side on desktop, stacked on mobile
- Accessible — 44px touch targets, ARIA labels, non-color-dependent states
- React 18 + TypeScript (strict mode)
- Vite 6 (build + dev server)
- CSS Modules (scoped styling, no runtime cost)
- localStorage (persistence, no backend)
- Vitest + React Testing Library + fast-check (property-based testing)
- AWS CDK (infrastructure as code)
- S3 + CloudFront + Route 53 + ACM (hosting)
| Document | Description |
|---|---|
| Architecture | Component structure, data flow, and design decisions |
| Testing | Test strategy, property-based tests, and how to run them |
| Deployment | AWS infrastructure, deploy process, and troubleshooting |
See LICENSE for details.