Harvests
A harvest is a record of what you actually picked from a planting: how much it weighed, how many you got, and what it was worth. Where an observation of type Harvest is a quick note (“picked some tomatoes”), the harvest log is the quantified ledger underneath it. Log harvests through the season and the dashboard shows you a single number: what your garden produced, in dollars.
The list
Above the list, a summary strip shows your season totals and an 8-week trend. Each card shows date, planting, weight, and value; count, $/lb, and source are in the expand and as optional table columns. You can log a harvest from this page or quick-log it from a planting (it pre-fills where it came from). Dollar value and the $ in the summary are an Advanced/Expert feature; on the Free level you see weight and count, and the trend is in pounds.
What a harvest record holds
| Field | What it is |
|---|---|
| Date | When you picked it. Defaults to today; adjust it if you are logging something from earlier. |
| Weight (lb) | Pounds harvested. This drives the value. |
| Count | The unit count, e.g. 12 tomatoes. Optional, for things you count rather than weigh. |
| Price per lb | The market price you are valuing it against, in dollars per pound. |
| Source | Where that price comes from (see below). |
| Notes | Anything else worth recording. |
A harvest can be tied to a specific planting or left general. Tying it to a planting rolls the value up into that planting’s running total on its detail page.
How estimated value is computed
Estimated value is weight times market price: weight_lb x market_price_per_lb. So 3 lb of tomatoes valued at $4.00/lb is an estimated $12.00.
The database computes this, not the app. It is a generated column, which means the value is always exactly weight times price with no chance of the displayed number drifting from the inputs. You cannot type the dollar value in directly — you set the weight and the price, and the value follows. The garden’s season total on the dashboard is just the sum of every harvest’s estimated value.
Count is recorded but not part of the value math. Pounds only for now — there is no grams or kilograms option in this version.
Price sources
The source records where your price comes from, so a $4/lb tomato priced at a farmers market reads differently from one priced at grocery shelf cost:
- Farmers market — what you would pay a local grower.
- Grocery store — supermarket shelf price.
- CSA rate — the per-pound rate implied by a community-supported-agriculture share.
- Other — anything else.
Price lookup is manual. You enter the price you want to value against; GardenOS does not fetch live market prices.
Who can log a harvest
Harvests follow the same access rules as the rest of your garden:
- Owner — full access: log, edit, and delete harvests.
- Companion — read and write: can log, edit, and delete harvests.
- Observer — read-only: can see the harvest log and the season total, but cannot add or change anything.
Logging a harvest
The quickest way is from the planting you picked from:
- Open the planting’s detail page.
- Find Log harvest, below Log observation.
- Set the date, weight, optional count, price per lb, and source.
- Optionally tick mark this planting harvested to also move the planting to its harvested status.
- Save. It appears immediately with its estimated value, and the planting’s running total updates.
You can also add one from the Harvests page with New harvest, and link it to a planting there.
The harvest log
The Harvests page shows your full log, newest first, with a season-value header at the top. Search across notes and source, and use the Filter & Sort button for everything else. It opens a drawer holding the sort order (Date, Value, Weight, or Source) and the filters: Source, Date, and Planting. Tick several values in a field to match any of them (OR); across fields they all apply (AND). The Source values each show how many harvests they would match. Tap Show items to apply. Active filters also show as removable chips below the toolbar, so you can drop one without reopening the drawer. Harvests show everything by default — there is no starting filter.
The Date filter also drives the season-value header at the top: set a Before/After/On/Between date and the dollar figure narrows to that window. Clear the Date filter and the header goes back to all time.
The cards/table choice sticks per page on this device, with a Roomy/Compact density toggle in the cards view. In the table view, a Columns button lets you choose which columns show and reorder them, also saved per page. Switch on Edit to change entries in place in either view: the table edits cells, and each card’s date, weight, and count become inline fields. Each change saves on its own. The estimated value is read-only because the database generates it; change the weight or price and the value recomputes.
Across all your gardens
If you run more than one garden, the global Harvests view (the top-level Harvests link when you are in the all-gardens scope) pools every garden’s harvests into one list, each row labeled with its garden. It leads with a single cross-garden total: what everything you grew, everywhere, was worth. Filter by garden or source, and tap any row to jump to that garden’s own harvest log. This view is part of the advanced tier; on the free tier the link takes you to your garden’s harvests instead.
Tips
- Log harvests consistently if you want the season total to mean anything. Even a rough weight beats skipping it.
- Pick one price source and stick with it across the season so year-over-year comparisons stay honest.
- A deleted planting does not erase its harvests — the economics stay on file, just unlinked.