diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 96ccfc8..102c5cc 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -1,60 +1,12 @@
# Contributing to OpenSprout
-Thanks for helping grow OpenSprout. Beginners, docs fixes, design feedback, bug reports, and careful plant-care nerd notes are all welcome.
+Please see [docs/Contributing.md](docs/Contributing.md) for the full contributing guide.
-## Ways to Contribute
+## Quick Links
-- Report bugs.
-- Suggest features.
-- Improve documentation.
-- Pick up `good first issue` tasks.
-- Add tests and accessibility improvements.
-- Improve self-hosting and privacy docs.
+- [Development Setup](docs/Development.md)
+- [Architecture](docs/Architecture.md)
+- [Deployment](docs/Deployment.md)
+- [Testing](docs/Testing.md)
-## Development Setup
-
-```bash
-npm install
-cp .env.example apps/web/.env.local
-npm run dev
-```
-
-Add your Supabase project URL and publishable key to `apps/web/.env.local` when working on authenticated or database-backed flows. Never use a Supabase service role key in frontend environment variables.
-
-## Branches and Commits
-
-Use descriptive branches such as:
-
-- `feature/plant-profiles`
-- `fix/reminder-timezone`
-- `docs/self-hosting-guide`
-
-Suggested commit prefixes:
-
-- `feat:`
-- `fix:`
-- `docs:`
-- `test:`
-- `refactor:`
-- `chore:`
-
-## Pull Requests
-
-- Keep PRs focused.
-- Explain what changed and why.
-- Link related issues.
-- Include screenshots for UI changes.
-- Add or update tests when behavior changes.
-- Mention privacy, accessibility, or self-hosting impact when relevant.
-
-## Design Principles
-
-- Privacy-first.
-- Self-hostable by default.
-- Accessible and mobile-friendly.
-- Beginner-friendly without hiding useful detail.
-- No subscriptions, trackers, or lock-in.
-
-## Security
-
-Please do not open public issues for sensitive vulnerabilities. Follow the disclosure process in [SECURITY.md](SECURITY.md).
+By contributing, you agree that your contributions will be licensed under AGPLv3.
diff --git a/README.md b/README.md
index 73e3636..d250b08 100644
--- a/README.md
+++ b/README.md
@@ -1,245 +1,183 @@
-# OpenSprout
+
+
+
+
+
+
OpenSprout
+
+ Privacy-first plant care, open to everyone.
+
+ Track plants, care schedules, watering logs, and journal entries — no subscriptions, no data lock-in.
+
-**OpenSprout is a privacy-minded, open-source plant care dashboard for tracking plants, care schedules, and watering or fertilizing logs without subscriptions or data lock-in.**
+
-[Live demo](https://sprout.kovina.org) · [Architecture](docs/architecture.md) · [Roadmap](docs/roadmap.md) · [Contributing](CONTRIBUTING.md) · [Security](SECURITY.md)
+
-OpenSprout is built for people who want a practical plant tracker they can inspect, self-host, and improve. It currently supports authenticated plant tracking, built-in care templates, schedule-based reminders, care logs, plant journal entries, photo uploads to private Supabase Storage, JSON export, a standalone Android app via Capacitor, and **AI agent integration via MCP**. It does not yet include push notifications, offline sync, or import/restore.
+[](https://sprout.kovina.org)
+[](https://play.google.com/store/apps/details?id=org.kovina.opensprout)
+[](https://github.com/sparshsam/opensprout/releases)
+[](https://github.com/sparshsam/opensprout)
-## Screenshots
+
-
+
-| Mobile dashboard | Dashboard concept |
-| --- | --- |
-|  |  |
-
-## Why OpenSprout?
-
-Most plant care apps eventually become a subscription, a closed data silo, or both. OpenSprout takes a different path:
-
-- **No subscriptions**: the project is free and open-source.
-- **Portable data**: users can export their rows as JSON.
-- **Self-hostable direction**: the stack is ordinary Next.js, Supabase, and PostgreSQL.
-- **Open improvements**: AGPLv3 keeps public hosted improvements open to the community.
-
-## Current Status
-
-**Maturity:** Prototype. Core workflows are functional (auth, plant CRUD, care schedules, care logs) but breaking changes are expected as the API and data model stabilize.
-
-The public demo is deployed on Vercel and backed by Supabase.
-
-| Area | Status | Notes |
-| --- | --- | --- |
-| Authentication | Available | Supabase email/password auth with session persistence. |
-| Plant dashboard | Available | Protected dashboard for signed-in users. |
-| Plant CRUD | Available | Create, edit, delete, and inspect persisted plants. |
-| Care Templates | Available | 30 built-in plant species templates with suggested care rhythms. |
-| Schedules | Available | Watering and fertilizing schedules are created from user inputs/templates. |
-| Care logs | Available | Mark plants watered or fertilized and persist logs. |
-| JSON export | Available | Exports user-owned rows currently loaded by the app/backend. |
-| Journal entries | Available | Create, edit, delete journal entries with title, body, health score, tags, and optional photo attachments. |
-| Photos | Available | Capture from camera or gallery (Android), or file picker (web). Uploaded to private Supabase Storage. Plant cover photos, journal photo attachments, and visual timelines. |
-| PWA foundation | Partial | Manifest and service worker exist; offline sync is not complete. |
-| Import/restore | Planned | Schema includes transfer metadata; restore flow is not complete yet. |
-| Push reminders | Planned | Not implemented yet. |
-
-## Ecosystem Role
-
-OpenSprout is the **care systems** project in the [Sparsh Sam ecosystem](https://github.com/sparshsam/ecosystem-standards). It provides privacy-first, open-source infrastructure for tracking living things that need routine attention — starting with houseplants, but designed for the general pattern of schedules, logs, and long-running stewardship routines.
-
-All repositories follow the [ecosystem standards](https://github.com/sparshsam/ecosystem-standards) for documentation, security, naming, and maturity classification.
-
-## Quick Start
-
-```bash
-git clone https://github.com/sparshsam/opensprout.git
-cd opensprout
-npm install
-cp .env.example apps/web/.env.local
-npm run dev
-```
-
-Then open [http://localhost:3000](http://localhost:3000).
-
-You need a Supabase project with the OpenSprout schema applied before authenticated plant data will work locally.
-
-## Environment Variables
-
-Configure these in `apps/web/.env.local` for local development and in Vercel for deployments.
-
-| Variable | Required | Description |
-| --- | --- | --- |
-| `NEXT_PUBLIC_SUPABASE_URL` | Yes | Supabase project URL used by the web app. |
-| `NEXT_PUBLIC_SUPABASE_PUBLISHABLE_KEY` | Yes | Browser-safe Supabase publishable key. |
-
-Do not expose Supabase service role keys in `NEXT_PUBLIC_` variables or client-side code.
-
-## Supabase Setup
-
-The schema source of truth lives in [`supabase/migrations`](supabase/migrations).
-
-It currently includes:
-
-- user profiles
-- read-only `plant_species` Care Templates
-- user-owned plants
-- care schedules
-- care logs
-- journal and photo metadata tables for future features
-- export/import metadata
-- sync device metadata
-- private `plant-photos` Storage bucket
-- RLS policies for user-owned data
-
-For local Supabase development:
-
-```bash
-supabase start
-supabase db reset
-```
-
-Then copy the local Supabase URL and publishable key into `apps/web/.env.local`.
-
-The hosted demo database was updated through Supabase SQL execution while the repo migrations remain the reviewable source of truth.
+---
-## Development
+## Gallery
-The web app lives in [`apps/web`](apps/web).
+
+
+
+
+
+
+
+
-```bash
-npm run dev # Start the Next.js app
-npm run lint # Run ESLint
-npm run typecheck # Run TypeScript checks
-npm run build # Build for production
-```
+
-CI runs `npm ci`, `npm audit --audit-level=high`, lint, typecheck, and build on pushes and pull requests.
+---
-## Project Structure
+## Why OpenSprout
-```text
-opensprout/
-|-- apps/web # Next.js 15 app
-|-- apps/mcp # MCP server for AI agent integration
-|-- packages/ # Future shared packages
-|-- docs/ # Architecture, MCP, roadmap, license notes, screenshots
-|-- supabase/migrations # PostgreSQL schema, RLS, seeds
-|-- .github/ # Workflows, issue templates, project docs
-|-- SECURITY.md # Vulnerability disclosure policy
-|-- CONTRIBUTING.md # Contributor guide
-`-- LICENSE # AGPLv3
+Most plant care apps eventually become a subscription, a closed data silo, or both. OpenSprout takes a different path.
-## AI Agent Integration (MCP)
+**No subscriptions.** **Portable data** — export your rows as JSON anytime. **Self-hostable** — the stack is ordinary Next.js, Supabase, and PostgreSQL. **Open improvements** — AGPLv3 keeps public hosted improvements open to the community.
-OpenSprout includes an [MCP server](apps/mcp) that lets AI agents like Claude Code, Hermes Agent, and Cursor read your plant data and perform actions on your behalf.
+
-**25 tools** are available covering plant management, care tracking, journal entries, species knowledge, and plant identification.
+---
-- [`docs/mcp-integration.md`](docs/mcp-integration.md) — Setup guide for connecting AI agents
-- [`docs/mcp-agent-prompts.md`](docs/mcp-agent-prompts.md) — Ready-to-use natural-language prompt pack
-- [`docs/mcp-reliability-audit.md`](docs/mcp-reliability-audit.md) — Step-by-step reliability audit guide
-```
+## Features
-## Deployment
+
-The public demo is deployed on Vercel:
+| | |
+|---|---|
+| **Plant CRUD** — Create, edit, delete, inspect plants | **Care Templates** — 30 built-in species templates with suggested care rhythms |
+| **Care Schedules** — Watering and fertilizing schedules from templates or custom inputs | **Care Logs** — Mark plants watered or fertilized and persist logs |
+| **Journal Entries** — Title, body, health score, tags, optional photo attachments | **Photo Uploads** — Capture from camera or gallery, stored in private Supabase Storage |
+| **JSON Export** — Export your data anytime | **Android App** — Capacitor-based native Android experience |
+| **AI Agent Integration (MCP)** — 25 tools for plant management via Claude, Hermes, Cursor | **PWA** — Installable as a standalone web app |
-[https://sprout.kovina.org](https://sprout.kovina.org)
+
-Vercel needs the same Supabase environment variables listed above. Production and Development variables are configured for the current demo project. Preview deployments may need Supabase variables configured separately in Vercel, depending on whether they apply to all branches or a specific branch.
+
-The root [`vercel.json`](vercel.json) configures the monorepo build output and edge security headers.
+---
-## Security and Privacy Notes
+## Designed For
-OpenSprout is privacy-minded, not zero-knowledge.
+**People who care for living things and want practical, private tracking.**
-- User-owned rows are isolated with Supabase Auth and PostgreSQL RLS.
-- The frontend uses only the Supabase publishable key.
-- Service role keys must never be exposed to the browser.
-- Data in the hosted demo is stored in Supabase PostgreSQL, not client-side encrypted.
-- The app now sets CSP and common browser security headers on the deployed site.
-- Basic in-memory API rate limiting is included, but it is not a distributed production-grade limiter.
-- Account deletion, import/restore, and full offline sync are still planned work.
+- **Houseplant owners** tracking watering schedules across a collection
+- **Gardeners** logging seasonal care routines
+- **Plant enthusiasts** journaling growth with photos and health scores
-Please report sensitive issues through [SECURITY.md](SECURITY.md), not public issues.
+
-## Roadmap
+---
-### v0.1: Usable MVP
+## Design Philosophy
-- Supabase Auth
-- protected dashboard
-- plant CRUD
-- Care Templates
-- watering/fertilizing schedules
-- care logs
-- JSON export
-- public Vercel demo
-- basic security hardening and CI
+> _"A care dashboard, not a social network."_
-### v0.2: Care Tracking Polish
+Every feature serves one purpose: helping you remember what your plants need. No feeds, no likes, no notifications you didn't ask for. Dark-mode first, clean typography, generous spacing. Data is yours — portable, exportable, never sold.
-- edit care schedules after creation
-- richer care log forms
-- plant detail timeline
-- archive plants instead of hard delete
-- better empty states and onboarding
+
-### v0.3: Photos and Reminders
+---
-- private plant photo uploads
-- plant health journal UI
-- calendar view
-- reminder task workflow
-- push notification research
+## Built With
-### v1.0: Self-Hostable Stable Release
+
+
+
+
+
+
+
+
+
-- documented self-host path
-- import/restore flow
-- offline sync queue
-- accessibility and security review
-- expanded community plant template process
+
-See the full roadmap in [`docs/roadmap.md`](docs/roadmap.md).
+---
-## Contributing
+## Version Journey
-Contributions are welcome, especially focused bug fixes, docs improvements, accessibility work, and careful plant template additions.
+| Version | Date | Highlights |
+|---------|------|------------|
+| **v0.9.0** | 2026-06 | MCP server with 25 AI agent tools, photo uploads |
+| **v0.8.0** | 2026-05 | Android app (Capacitor), full Android project |
+| **v0.7.0** | 2026-05 | Journal entries, health scores, tag system |
+| **v0.6.0** | 2026-04 | Photo uploads, plant cover photos, timeline |
+| **v0.5.0** | 2026-04 | Care schedules, logging, JSON export |
+| **v0.4.0** | 2026-03 | Care templates (30 built-in species) |
+| **v0.3.0** | 2026-03 | Plant CRUD, species database |
+| **v0.2.0** | 2026-02 | Auth, dashboard, initial stack |
+| **v0.1.0** | 2026-01 | Project scaffold, Supabase schema |
-Start with:
+[Full Changelog](CHANGELOG.md)
-- [`CONTRIBUTING.md`](CONTRIBUTING.md)
-- [`docs/architecture.md`](docs/architecture.md)
-- [`docs/roadmap.md`](docs/roadmap.md)
-- [good first issue ideas](.github/project.md)
+
-Keep pull requests small, include screenshots for UI changes, and call out privacy/security implications when relevant.
+---
## License
-OpenSprout is licensed under the GNU Affero General Public License v3.0 or later.
-
-AGPLv3 allows use, study, modification, and self-hosting, but modified versions made available over a network must preserve the same source-availability obligations. See [`LICENSE`](LICENSE) and [`docs/license-notes.md`](docs/license-notes.md).
+AGPLv3 — see [LICENSE](LICENSE)
----
+Built by [@sparshsam](https://github.com/sparshsam)
-*Last updated: June 2026*
+
-## Tech Stack
+---
-| Layer | Choice |
-|-------|--------|
-| Framework | Next.js (App Router) |
-| Language | TypeScript |
-| Styling | Tailwind CSS |
-| Data | Local-first with optional sync |
+## Part of the Open Collection
+
+
+
+
+
+
+ OpenPalette
+ A color studio for designers
+ Repo ·
+ Web
+
+
+
+ OpenSend
+ Free file sharing, no account needed
+ Repo ·
+ Web
+
+
+
+ OpenSprout
+ Plant care records
+ Repo ·
+ Web
+
+ 
+
+ 
+ 
+ 
+ 
+
