AgroPulse is ready to use the moment you sign in. This guide walks you through the onboarding flow from first login to your first live sensor reading — including what to expect if you’re an operator waiting for greenhouse access, and how to unlock the AI assistant.Documentation Index
Fetch the complete documentation index at: https://mintlify.com/diarpicu2022-commits/frontend-AgroPulse/llms.txt
Use this file to discover all available pages before exploring further.
Sign in with Google
Navigate to the AgroPulse login page and click the Google tab, then click Continue with Google. AgroPulse uses Supabase OAuth, so no password is required — your Google account is your identity.After you authenticate, the app contacts the backend to register or retrieve your account. Your Google display name and profile photo are used automatically.
The backend is hosted on Render’s free tier and may be in a cold-start state when you first sign in. If the login spinner runs for several seconds, that’s expected — the server is waking up. The app falls back to a local session and re-syncs your account once the backend responds (typically within 8 seconds).
Wait for greenhouse access (operators only)
If you signed up as an operator, you won’t see any greenhouse data until an admin assigns you access. After login you’ll see a “Verifying access…” screen while the app checks whether your account has been assigned to any greenhouses.If no assignment exists after 8 seconds, you’ll land on the No Access page. You can click Retry at any time to re-check — this is useful right after an admin has just granted you access.Admins skip this step entirely — they have unrestricted access to all greenhouses as soon as they log in.
Contact your AgroPulse administrator and provide the email address you used to sign in with Google. The admin assigns greenhouses from the Roles panel under Administration.
Open the Dashboard and select a greenhouse
Once access is confirmed, you land on the Dashboard (Inicio). Use the greenhouse selector at the top of the page to choose which greenhouse to inspect.Admins see all registered greenhouses. Operators see only the greenhouses they have been assigned.From the sidebar you can also navigate to Greenhouses (admins) to see a full list, or to Map to see greenhouse locations plotted geographically.
View live sensor readings
With a greenhouse selected, the Dashboard displays real-time sensor cards updated every few seconds from the ESP32 devices connected to that greenhouse. Each card shows the current reading, the sensor type (temperature, humidity, CO₂, soil moisture, light, or pressure), and a trend indicator.To dig deeper, go to Sensors in the sidebar for a full list of registered sensors with historical sparklines and alert thresholds, or to Analytics for time-series charts.
Configure AI keys in Settings
The AI Agronomic Assistant (IA Agronómica) requires at least one API key to be active. Go to Settings (Configuración) in the sidebar.Under AI you can add keys for up to three providers:
Paste your key into the corresponding field and click Save all keys. Keys are stored in your browser’s localStorage and are never sent to the AgroPulse backend.Once at least one key is saved, open IA Agronómica from the sidebar to start asking questions about your crops and sensor data.
| Provider | Key prefix | Model used |
|---|---|---|
| Groq | gsk_... | llama-3.1-8b-instant |
| GitHub AI | ghp_... | openai/gpt-4o-mini |
| Google Gemma | AIza... | gemma-4-31b-it |
What’s next
Authentication
Learn how Google OAuth works, understand the two roles, and see how greenhouse access is managed.
Dashboard
Explore sensor cards, live charts, and the alert feed on the main control panel.
Sensors & Actuators
Register sensors, set thresholds, and control actuators from the dashboard.
AI Assistant
Ask agronomic questions and get recommendations based on your live sensor context.