WhatIGrow — Full App Breakdown

Fields: name (string, required), scientific_name (string), type (string), growth_cycle (string), min_temp (number °C), max_temp (number °C), min_humidity (number %), max_humidity (number %), watering_frequency (string), sun_preference (string), fertilizer_ratio (string N-P-K), frost (string enum: "Yes"/"No"/"Protected is okay"), detailed_care_info (string, multi-paragraph guide), care_blurbs (object with 8 string sub-fields: temperature, humidity, watering, sun, fertilizer, growth_cycle, type, frost), image_url (uri), grow_space_id (string ref to GrowSpace), date_planted (date), identification_status (string enum: "identifying"/"identified"/"failed"), identification_error (string).

Fields: name (string, required), type (string enum: "greenhouse"/"indoor"/"outdoor"/"custom", default "indoor"), custom_label (string, used when type is "custom").

Fields: plant_id (string ref, required), plant_name (string), image_url (uri, required), description (string, user notes), diagnosis (string, AI), instructions (string, AI treatment), severity (string enum: "Low"/"Moderate"/"High"/"Critical", default "Moderate").

Fields: title (string), media_url (uri, required), media_type (string enum: "image"/"video", required).

This is the heart of the AI logic. It exports:

• PLANT_CARE_SCHEMA — a JSON schema object (type: object) the LLM must return, with all 14 plant fields + the nested care_blurbs object (8 required sub-fields). The frost field is an enum.
• IDENTIFY_PROMPT — a botanist persona prompt that embeds a JSON_STRUCTURE template string describing exactly what each field should contain.
• buildCorrectPrompt(name) — a prompt for re-generating care info from a known plant name (used when a user corrects a misidentified plant).

1. identifyPlant — Auth-required. Takes image_url, calls InvokeLLM with IDENTIFY_PROMPT + the image as file_urls + PLANT_CARE_SCHEMA. Returns {{ plant }}. (Synchronous, used by older flows.)
2. identifyPlantBackground — The main identification path. Takes plant_id. Fetches the plant (asServiceRole), guards on identification_status === 'identifying', retries up to 3 times with 2s delay, writes all care fields + identification_status: 'identified' back to the Plant, or 'failed' with the error. Fire-and-forget from the client after creating a plant.
3. correctPlantInfo — Auth-required. Takes name, calls InvokeLLM with buildCorrectPrompt(name) + PLANT_CARE_SCHEMA. Returns {{ plant }}. Used when a user edits a plant's name inline — it regenerates all care data.
4. diagnoseProblem — Auth-required. Takes image_url, plant_name, plant_type, care_context, description. Builds a plant-pathologist prompt, calls InvokeLLM with the image, returns {{ diagnosis, instructions, severity }}.
5. generateGrowSpaceTips — Auth-required. Takes space_name, space_type, plants[]. Summarizes the plants, asks the LLM for a compatible temp/humidity range + multi-paragraph tips. Returns {{ recommended_temp_min/max, recommended_humidity_min/max, tips }}.
6. getPublicGallery — Public. Takes user_id. Returns that user's GalleryMedia + Plant images (filtered to those with URLs). Powers the shareable /gallery/:userId page.
7. getWeather — Public. Takes latitude/longitude, calls Open-Meteo, splits today into daytime (7AM–7PM) and overnight (7PM–7AM) highs/lows, returns a 7-day week forecast. (The app actually calls Open-Meteo directly from the browser via src/lib/weatherApi.js to avoid shared-IP rate limits — this backend function exists as a fallback/alternative.)
8. guestIdentifyPlant — Public (no auth). Takes image_data_url (base64 data URL), converts to a Blob, uploads via UploadFile, then calls InvokeLLM with the image + IDENTIFY_PROMPT. Returns {{ plant, image_url }}. No persistence.
9. backfillPlantCareData — Admin-only. Finds all plants missing frost or care_blurbs.frost, regenerates their care data via buildCorrectPrompt. One-time migration utility.

• Loads all Plants + GrowSpaces. Realtime subscription on the Plant entity updates cards in place when background identification finishes.
• Groups plants by grow space into GrowSpaceSection components (collapsible).
• Two view modes: Garden (grouped cards/tables) and List (PlantListView — printable, sortable).
• Select mode: checkboxes to multi-select plants, then a sticky bottom bar with "Move to…" (MovePlantsDialog bulk-updates grow_space_id).
• Empty states differ for guests (shows "Identify a Plant" CTA) vs. authenticated (shows "Add your first plant").
• Each care attribute is a click-to-open CareBlurbDialog.

Full plant view: large image, editable name (pencil icon → inline edit → calls correctPlantInfo and regenerates ALL care data), grid of 8 care attribute cards (each opens CareBlurbDialog), and the full detailed_care_info guide. "Have a Problem?" button → PlantProblems.

Upload a photo of a sick plant + optional description → calls diagnoseProblem → saves a Problem record → shows diagnosis, severity badge, treatment instructions. Lists problem history below.

Grid of grow space cards with plant counts. "New Space" opens AddGrowSpaceModal. Shows a warning for unassigned plants.

Calculates the overlapping temp/humidity range across all plants in the space (max of mins / min of maxes) and warns if incompatible. Calls generateGrowSpaceTips for AI recommendations. Lists plants.

Temperature unit toggle (°C/°F, persisted to localStorage via useTempUnit). Replay tour button.

Upload images/videos to GalleryMedia. Shows user's setup media + all plant photos. "Share" copies a public link /gallery/:userId which renders via getPublicGallery (no auth needed).

Standard Base44 boilerplate — email/password, Google OAuth, OTP verification on register, reset flow. Don't recreate these; they ship with every new app.

1. User opens AddPlantModal, picks a grow space, takes/uploads a photo.
2. Photo → UploadFile → get file_url.
3. Creates a Plant with name: 'Identifying…', image_url, grow_space_id, identification_status: 'identifying'.
4. Fires identifyPlantBackground({{ plant_id }}) (fire-and-forget) and closes the modal.
5. Garden shows an "Identifying…" card with a spinner.
6. Backend function calls InvokeLLM with the image + PLANT_CARE_SCHEMA (retries 3×), writes all care fields + identification_status: 'identified'.
7. Realtime subscription in Home picks up the update → card refreshes with the real name + care data.

1. GuestIdentifyModal → photo → base64 data URL → guestIdentifyPlant → uploads + identifies → returns care info inline (no DB write).
2. "Create Free Account to Save" CTA → /register.

1. From a plant → "Have a Problem?" → upload photo + description.
2. diagnoseProblem (with plant context) → {{ diagnosis, instructions, severity }}.
3. Saved as a Problem record; shown in problem history.

1. PlantDetail → pencil icon → edit name → correctPlantInfo({{ name }}) → regenerates ALL care data from the name → updates the Plant.

1. GrowSpaceDetail computes the mathematical overlap of all plants' temp/humidity ranges.
2. generateGrowSpaceTips sends the plant list to the LLM for a compatible range + tips.