Tea Shelf

A static PWA for saving Camellia Sinensis teas, caching product details locally, and tracking brew timers.

Warning

This project was mostly vibe coded. Use at your own risks.

Features

• Search Camellia Sinensis from the app.
• Save teas with a browser bookmarklet.
• Cache descriptions, product information, flavour wheel, packages, and brewing methods.
• Track teas you own or like.
• Sort the shelf by last brew, name, or date added.
• Brew timers update the tea's last brewed time.
• Import and export local backups.

Development

npm install
npm run dev

Build the static app:

npm run build

Preview the build:

npm run preview

Deploy

Deploy to GitHub Pages:

npm run deploy

This builds the app and publishes dist to the gh-pages branch.

Saving Teas

Camellia blocks cross-origin browser requests, so the app cannot fetch tea pages directly from GitHub Pages. Instead:

1. Open the deployed app.
2. Go to Add.
3. Drag Save Tea to your browser bookmarks bar, or click it to copy the bookmarklet.
4. Search Camellia and open a tea product page.
5. Click the Save Tea bookmarklet while on that Camellia page.

The bookmarklet reads the already-loaded product data and sends it back to Tea Shelf.