Hostinger Deployment Guide · June 2026

56-File Platform
Deployment.

Complete guide for uploading and configuring the HelloAG AgOS platform on Hostinger Apache shared hosting. Covers all four layers: institutional website, intelligence dashboards, platform modules, and JS libraries.

56 Files 28 Clean URL Routes Hostinger hPanel ⚠ Supabase Key Required
Before You Upload Anything

Critical fixes
required first.

Two issues currently break the live site entirely. Fix these before uploading any other files or the platform will appear to work while silently failing all data queries.

Critical 1 — All Live Data Is Silent-Failing
The Supabase anon key in helloag-databridge.js is a placeholder

Every price chart, FSI score, ABRS figure, and CVI calculation on the platform is running on fallback/hardcoded data. The actual 186,000+ AMIB records are not being queried. The key ends in .placeholder and must be replaced before the platform is used in any demo or meeting.

Fix: Open helloag-databridge.js locally. Find the line const SUPABASE_ANON = 'eyJ...placeholder'. Replace the entire value with the real anon key from: Supabase Dashboard → Project HAIS-JASPIS-PROD → Project Settings → API → Project API Keys → anon public. Save and re-upload.

Critical 2 — Homepage Is Wrong Version
The live index.html is the old four-pillar persona selector, not the institutional homepage

Anyone visiting helloagriculture.com currently sees the operator dashboard entry point, not the institutional homepage. The new index.html — "The Operating System for Food Security" — must replace it.

Fix: In Hostinger File Manager, rename the existing index.html to platform.html first. Then upload the new index.html. Order is critical — if you upload first, Hostinger will ask to overwrite and the old platform file is lost.

Complete File Inventory

56 files across
four layers.

Upload all 56 files to public_html root. Flat structure — no subdirectories. The .htaccess handles all routing.

Institutional Website · Public-Facing 13 files · the homepage + solutions + research + consulting
🏠
index.html
helloagriculture.com/
New institutional homepage — "The Operating System for Food Security". Replaces old persona selector which moves to /platform.
Upload Last
📖
about.html
/about
Origin story — Mile Gully → Cornell → Jamaica deployment. Founder bio. Institutional relationships. CADE Group / TEA-RED future.
New
📚
research.html
/research
Research Library — three collections, 11 papers, lead capture modal per paper. Publishing pyramid. Notification signup.
New
🤝
consulting.html
/consulting
Three service tiers, four-phase engagement model, contact form. Form submissions broadcast to CRM via BroadcastChannel.
New
📰
knowledge-center.html
/knowledge-center
Content hub — six category cards, newsletter signup. Links to research library.
New
🌍
project-tea-red.html
/project-tea-red
TEA-RED institutional framework — T/A/R pillars, five focus areas, CARICOM rollout map.
New
⚙️
helloag-os.html
/helloag-os
Platform explainer for non-technical visitors. Four-pillar tabbed architecture. Not-an-app distinction block.
New
🧠
stakeholder-intelligence.html
/stakeholder-intelligence
Concept page — five stakeholder types, five information gaps, intelligence loop diagram. Links to research series.
New
🏛️
solutions-government.html
/solutions/government
Six platform capabilities for government. Digital Twin simulation callout. Partnership model. The four-part Ask.
New
🏨
solutions-tourism.html
/solutions/tourism
TAII hotel sourcing gap. Four-step TAII workflow. Commodity availability table. Link to live TAII portal.
New
🏦
solutions-finance.html
/solutions/finance
ABRS as credit underwriting. Portfolio intelligence. Country food security assessments for development banks.
New
🚢
solutions-agribusiness.html
/solutions/agribusiness
Price intelligence, GIS supply chain, JAMPRO export pathway via ABRS, verified supplier network.
New
🌍
solutions-development.html
/solutions/development
UN agencies, bilateral donors, NGOs. Country profiles, M&E infrastructure, Digital Twin for programme design.
New
Intelligence Dashboards · Platform Layer 12 files · FSI, CVI, Digital Twin, Import Monitor, GIS, Command Center
HelloAG_Command_Center.html
/command
Bloomberg-style national command center. Live KPIs, alert ticker, parish risk map, commodity feeds.
Updated
📊
HelloAG_Executive_Dashboard.html
/intelligence
Real Supabase views replacing all hardcoded data. Eight AMIB report types, dropdown-driven.
Updated
HelloAG_Digital_Twin.html
/twin
Eight disaster scenarios — Hurricane, Drought, Flooding, Import Disruption, Tourism Surge, Disease, Fertilizer, Transport. Real economic calculations.
Updated
🌾
HelloAG_FSI_Dashboard.html
/fsi
Jamaica's first National Food Security Index — four components, parish breakdown, 12-week trend.
Updated
📈
HelloAG_CVI_Dashboard.html
/cvi
Commodity Volatility Index — 12 commodities, weekly AMIB data. CVI 31 elevated.
Updated
🌾
HelloAG_JAIS_Dashboard.html
/jais
Jamaica Agricultural Intelligence System — harvest calendar, agro-zone clusters, production estimates.
Updated
📦
HelloAG_Import_Monitor.html
/imports
US$840M import bill tracking. US$310M substitution opportunity. J$29B five-year forex target.
Updated
📄
HelloAG_Executive_Brief.html
/brief
Government-facing leave-behind. Four asks. Live data embedded. For PM meeting and Denbigh VIP contacts.
Updated
🗺️
HelloAG_GIS_Map.html
/map
Leaflet parish map. Supply corridors, agro-zone classification, parish FSI overlay.
Updated
🔮
HelloAG_Yield_Forecast.html
/forecast
90-day price forecasting — EMA + seasonal + linear slope. 12 commodities. ±1.5σ confidence bands.
New
🤖
HelloAG_AI_Recommendations.html
/recommendations
30-rule recommendation engine. Persona-filtered by stakeholder type. Rule-based, not AI API yet.
New
🛡️
HelloAG_Sentinel_Simulation.html
/simulation
Test Sentinel broadcast scenarios. Alert reach modelling. Parish coverage gap detection.
Updated
Platform Modules · Connect / Sentinel / Insights 15 files · TAII, ABRS, Farmer Registration, POS, Dispatch, Analytics
🌍
tab-taii.html
/connect
TAII Tourism Portal — 10 panels, full command center aesthetic. Supply gaps, hotel assets, demand forecasts, planting calendar, parish tiers, import substitution.
CSS Rebuilt
tab-abrs-dashboard.html
/sentinel
ABRS national farmer registry — Grade distribution, parish scores, national average 62, pilot average 74.
Updated
🌱
tab-farmer-selfregistration.html
/register
Mobile-first six-step farmer enrolment. GPS farm boundary, production reporting, ABRS self-assessment.
New
📊
tab-market-intelligence.html
/insights
AMIB price table — 12 commodities, weekly data, category filter. Now includes ← Platform topbar link.
Updated
📉
tab-analytics.html
/analytics
Platform analytics — user sessions, enrolments, API calls, revenue metrics.
Updated
⚙️
tab-copi-engine.html
/copi
COPI enterprise profitability engine — four enterprise types, cost/revenue/margin calculations.
Updated
📦
tab-inventory.html
/inventory
Farm inventory management — stock levels, harvest dates, produce categories.
Updated
💳
tab-pos-terminal.html
/pos
Point-of-sale terminal — farm gate, market, and delivery transactions. GS1-traceable records.
Updated
🚚
tab-delivery-dispatch.html
/dispatch
Route management, delivery confirmation, temperature logging, status notifications.
Updated
🔔
tab-notifications.html
/notifications
Sentinel alert management — pest, price emergency, climate. Parish targeting. Broadcast status.
Updated
⚙️
tab-settings.html
/settings
Platform settings — profile, notifications, Supabase connection, HAG-ID management.
Updated
🌤️
tab-weather.html
/weather
Weather intelligence — parish-level 7-day forecast, drought risk, hurricane season alerts.
Updated
📋
tab-reports.html
/reports
Platform report library — weekly price reports, ABRS cohort summaries, FSI updates.
Updated
🏢
tab-enterprises.html
/enterprises
Enterprise management — 16 registered enterprise types, crop cycles, production records.
Updated
🗺️
tab-gis-map.html
/gis
Platform GIS — farm boundary viewer, parish layers, supply corridor map.
Updated
Data Tools & CRM 2 files · Ask the Data · Stakeholder CRM
💬
ask-the-data.html
/data
Structured query interface — 186K+ AMIB price records. Four query types, five presets, SVG charts, CSV export. Auto-runs Market Overview on load.
New
📇
helloag_crm.html
/crm
Stakeholder CRM — 12 seed institutional contacts, kanban pipeline, CSV import, BroadcastChannel receiver. Receives form submissions from consulting.html and research.html automatically.
New
JavaScript Libraries 4 files · must be in public_html root
📡
helloag-databridge.js
Shared data bus — BroadcastChannel + localStorage + Supabase. Contains the Supabase anon key — update before uploading.
Fix Key First
🔧
helloag-nav.js
Platform navigation overlay. Replaces the old helloag-demo-overlay.js — delete the old file after uploading.
Updated
🤖
helloag-recommendations.js
30-rule recommendation engine. Persona-filtered. Identical output schema to the future Claude API Phase 2.
New
📈
helloag-forecast.js
Statistical forecasting library — EMA + seasonal + linear slope for 12 commodities.
New
Configuration 1 file · 28 clean URL routes
⚙️
.htaccess
Clean URLs for all 28 routes + HTTPS redirect + no-www → www 301 + GZIP + caching + security headers. Starts with a dot — enable Show Hidden Files in File Manager to confirm it uploaded correctly.
Config
Step-by-Step

Upload steps.
Order matters.

Follow these steps exactly. The rename on Step 2 must happen before Step 4 or the old AgOS platform will be overwritten and lost.

1
Fix the Supabase anon key in helloag-databridge.js

Open helloag-databridge.js locally in a text editor. Find the line const SUPABASE_ANON = 'eyJ...placeholder'. Replace the entire string value with the real anon public key from Supabase → Project Settings → API. Save. This is the most important step. Do it before anything else.

The anon key is intentionally safe to expose in client-side code — it is a read-only public credential. Do not confuse it with the service_role key, which must never appear in any file that uploads to Hostinger.
2
Log in to Hostinger hPanel → File Manager → public_html

Navigate to hPanel → Files → File Manager. Open the public_html folder. This is where all platform files live. Do not create any subdirectories — all 56 files deploy flat to the root.

3
Rename the existing index.html → platform.html

Find index.html in public_html. Right-click → Rename. Change to platform.html and confirm. This preserves the old four-pillar persona selector at helloagriculture.com/platform. The new institutional homepage replaces it as the root.

Do not skip this step. If you upload the new index.html before renaming, Hostinger will prompt to overwrite — accept and the old platform is gone permanently.
4
Upload all 56 files to public_html

In File Manager, click Upload. Select all 56 files at once. Hostinger supports batch upload. If any file conflicts with an existing one, choose Replace — this is intentional for updated files. The .htaccess will also be uploaded here.

After uploading, enable Show Hidden Files in File Manager settings (gear icon, top right) and confirm .htaccess appears. If it does not appear, it was filtered out — re-upload it individually.
5
Delete helloag-demo-overlay.js

If the old file helloag-demo-overlay.js exists in public_html, right-click → Delete. The new helloag-nav.js has replaced it. If it does not exist, skip this step.

6
Set file permissions to 644

Select all HTML, JS, and .htaccess files. Right-click → Permissions. Set to 644. This is the correct permission for public web files on Apache shared hosting. The .htaccess should also be 644.

7
Clear Hostinger CDN cache

In hPanel → PerformanceCDN, click Purge Cache. Also clear your browser cache (Ctrl+Shift+R or Cmd+Shift+R) before testing. Without clearing both, your browser may show cached old files even after upload.

8
Run the post-deploy test checklist

Verify every URL in the test checklist below. The most important checks are the homepage (new institutional design), Supabase data loading (FSI should show 74.2, not 0 or N/A), and the no-www redirect.

Configuration

The .htaccess
route map.

The .htaccess file handles all clean URLs, redirects, and security. The complete 28-route map is below. If a route returns 404, first check that the .htaccess file is visible (hidden files enabled) and that its permissions are 644.

Clean URLResolves ToLayer
/index.htmlInstitutional
/platformplatform.html (old AgOS)Platform
/aboutabout.htmlInstitutional
/consultingconsulting.htmlInstitutional
/researchresearch.htmlInstitutional
/knowledge-centerknowledge-center.htmlInstitutional
/project-tea-redproject-tea-red.htmlInstitutional
/helloag-oshelloag-os.htmlInstitutional
/stakeholder-intelligencestakeholder-intelligence.htmlInstitutional
/solutions/governmentsolutions-government.htmlInstitutional
/solutions/tourismsolutions-tourism.htmlInstitutional
/solutions/financesolutions-finance.htmlInstitutional
/solutions/agribusinesssolutions-agribusiness.htmlInstitutional
/solutions/developmentsolutions-development.htmlInstitutional
/intelligenceHelloAG_Executive_Dashboard.htmlIntelligence
/commandHelloAG_Command_Center.htmlIntelligence
/twinHelloAG_Digital_Twin.htmlIntelligence
/fsiHelloAG_FSI_Dashboard.htmlIntelligence
/cviHelloAG_CVI_Dashboard.htmlIntelligence
/jaisHelloAG_JAIS_Dashboard.htmlIntelligence
/importsHelloAG_Import_Monitor.htmlIntelligence
/briefHelloAG_Executive_Brief.htmlIntelligence
/mapHelloAG_GIS_Map.htmlIntelligence
/connecttab-taii.htmlConnect
/sentineltab-abrs-dashboard.htmlSentinel
/registertab-farmer-selfregistration.htmlSentinel
/insightstab-market-intelligence.htmlInsights
/dataask-the-data.htmlInsights
/forecastHelloAG_Yield_Forecast.htmlInsights
/crmhelloag_crm.htmlTools
/simulationHelloAG_Sentinel_Simulation.htmlSentinel
Supabase Configuration

Wiring
live data.

The platform connects to Supabase project HAIS-JASPIS-PROD (qnuyujjstnibidhwnxgx). All queries use the anon key — a read-only public credential. The service_role key must never appear in any client-side file.

1
Get the real anon key

Log in to supabase.com → Project HAIS-JASPIS-PROD → Project SettingsAPI → Project API Keys → copy the anon public key (the long eyJ... string that does not end in "placeholder").

2
Update helloag-databridge.js

Open the file locally. Find line 2:
const SUPABASE_ANON = 'eyJ...placeholder';
Replace the full quoted string with the real key. Save. Re-upload to Hostinger.

The anon key is safe to expose in client-side JavaScript. Supabase designed it for this purpose — it is a publishable key with read-only access enforced by Row Level Security on the database side.
3
Verify live data is loading

Visit helloagriculture.com/fsi. The FSI score should show 74.2 (computed from live AMIB data), not 0, N/A, or a loading spinner that never resolves. If it shows the fallback value, the key is still wrong or the Supabase project is paused.

Post-Deploy Verification

Test every
critical path.

Run these checks immediately after uploading. Browser-clear cache first (Cmd+Shift+R). Test from a private/incognito window to avoid cached sessions.

Homepage loads institutional design — visit helloagriculture.com. Should show dark hero with "The Operating System for Food Security" headline, not the old persona selector tiles.
http → https redirect — visit http://helloagriculture.com. Should redirect to https://www.helloagriculture.com with a 301.
No-www redirect — visit helloagriculture.com (no www). Should redirect to www.helloagriculture.com. Previously returned 403.
Supabase data loading — visit /fsi. FSI score should show 74.2. If it shows 0 or N/A, the anon key is still the placeholder.
/platform accessible — visit helloagriculture.com/platform. Should load the old four-pillar AgOS operator hub.
Clean URLs working — test /about, /consulting, /research, /solutions/government. All should load without 404.
TAII portal — visit /connect. Should load the dark command centre TAII with 10 subnav tabs. No green/white old aesthetic.
Digital Twin — visit /twin. Select Hurricane Cat 4, click Run. FSI impact and economic loss figures should calculate and display within 2 seconds.
Ask the Data — visit /data. Should auto-run Market Overview on load. Record count badge should show the live count (186,999+), not 0.
Farmer registration — visit /register. Six-step form should load. GPS location request should appear on Step 4.
CRM — visit /crm. Dashboard should show 12 seed contacts. Pipeline columns should render. CSV import button visible in topbar.
Consulting form → CRM — open /crm in one tab. Open /consulting in another. Submit the form. Return to CRM — a new lead should appear at top of contacts list within 3 seconds (BroadcastChannel delivery).
JS libraries loading — open browser DevTools → Network. Visit /intelligence. Confirm helloag-databridge.js, helloag-recommendations.js, and helloag-forecast.js all return 200.
.htaccess hidden file visible — in Hostinger File Manager, enable Show Hidden Files. Confirm .htaccess appears in public_html root.
Troubleshooting

Common problems
and fixes.

A clean URL returns 404

First, check that .htaccess is in public_html root and visible (enable Show Hidden Files in File Manager). If present, check permissions are 644 — 444 or 755 will prevent Apache from reading it. If permissions are correct, the .htaccess rule may be missing for that route — compare against the route table above.

Data shows 0 or N/A everywhere — FSI, CVI, record count

The Supabase anon key in helloag-databridge.js is still the placeholder. Open the file, replace the key ending in .placeholder with the real anon public key from Supabase → Project Settings → API. Re-upload. Also confirm the Supabase project HAIS-JASPIS-PROD is not paused in the Supabase dashboard — free tier projects pause after 7 days of inactivity.

Homepage still shows old persona selector after uploading

You uploaded the new index.html before renaming the old one, or Hostinger's CDN is serving a cached version. First, in Hostinger hPanel → Performance → CDN → Purge Cache. Then hard-refresh your browser (Cmd+Shift+R). If still wrong, confirm the file in public_html is the new institutional version — open it in File Manager and check that the title says "The Operating System for Food Security".

CRM does not receive consulting form submissions

The BroadcastChannel only works when both pages are open on the same domain in the same browser. Confirm: (1) both tabs are on www.helloagriculture.com (not one on http and one on https), (2) the consulting.html on the server is the updated version with the BroadcastChannel code — not the old version that just changed the button text. If the CRM tab was not open when the form was submitted, the lead enters the localStorage queue and will appear when the CRM is next opened (it polls every 3 seconds).

helloag-forecast.js returning 404

This file is new — it was not in the original deployment. Confirm it uploaded correctly. In Hostinger File Manager, search for "forecast" — if it does not appear, re-upload helloag-forecast.js individually. This file is required by HelloAG_Yield_Forecast.html at /forecast.

.htaccess file not visible in File Manager

Files starting with a dot are hidden by default. Click the gear icon in the top right of Hostinger File Manager and enable Show Hidden Files. If the .htaccess still does not appear, it was not uploaded — upload it again. Ensure your local file has the dot — some operating systems hide dotfiles from the file picker. If needed, rename it to htaccess.txt, upload, then rename it to .htaccess in File Manager.