From 40838b45170f92a4d78d78b53dcf3d2900ac0d85 Mon Sep 17 00:00:00 2001
From: Alejandro Repetto <contact@repetto-a.com>
Date: Sun, 7 Jun 2026 06:22:47 -0300
Subject: [PATCH] =?UTF-8?q?docs:=20rewrite=20README=20=E2=80=94=20award=20?=
 =?UTF-8?q?story,=20NASA=20data,=20architecture,=20setup?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 README.md | 132 +++++++++++++++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 130 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index e2823cc..8b29b1e 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,130 @@
-# NASA_SpaceApps2025
-Challenge: NASA Farm Navigators: Using NASA Data Exploration in Agriculture
+<div align="center">
+
+# 🌾 FarmHero
+
+**NASA Space Apps Challenge 2025 — Rosario Winner 🏆 & Global Nominee 🌍**
+
+[![Live Demo](https://img.shields.io/badge/demo-live-success?logo=vercel)](https://farmhero-sepia.vercel.app)
+[![NASA Space Apps](https://img.shields.io/badge/NASA%20Space%20Apps-2025-0B3D91?logo=nasa)](https://www.spaceappschallenge.org/)
+[![Next.js](https://img.shields.io/badge/Next.js-15-black?logo=next.js)](https://nextjs.org/)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5-3178C6?logo=typescript)](https://www.typescriptlang.org/)
+
+*A turn-based farm management simulator that uses real NASA Earth observation data to teach sustainable agriculture decisions.*
+
+[**▶ Play now →**](https://farmhero-sepia.vercel.app)
+
+</div>
+
+---
+
+## 🌍 The Challenge
+
+**"Farm Navigators: Using NASA Data Exploration in Agriculture"**
+
+Smallholder farmers in Argentina and LATAM manage critical decisions — irrigation, crop rotation, nitrogen management — with little access to actionable Earth-science data. FarmHero bridges that gap with a playable simulation that puts NASA satellite insights into practice.
+
+---
+
+## 🎯 What FarmHero Does
+
+FarmHero is a **browser-based educational simulator** where players manage a 9-plot farm across multiple seasons. Every decision has real-world consequences based on NASA and CONAE Earth data:
+
+- 🌱 **Choose crops** across 9 plots — each with growth stages and phenological data
+- 💧 **Manage resources** — water, nutrients, soil health, soil capital, and money
+- 🔄 **Plan crop rotation** — to prevent soil degradation across seasons
+- 💡 **Learn irrigation methods** — from drip irrigation to flood, with water-efficiency tradeoffs
+- 🐄 **Handle livestock decisions** — understand nutrient cycles and environmental impact
+- 🌿 **Optimize nitrogen management** — balance yield and environmental footprint
+- 📍 **Select your region** — different climate zones affect every strategy
+- 📊 **Review season reports** — learn what worked and why
+
+---
+
+## 🛰️ NASA Data Integration
+
+FarmHero was built around the **NASA Space Apps challenge**, using Earth observation data to drive game mechanics:
+
+| Data Source | Used For |
+|---|---|
+| NASA Earth observation datasets | Crop growth models, regional climate parameters |
+| Phenological data | Seasonal crop stage progression |
+| CONAE (Argentine Space Agency) | Regional soil and precipitation context |
+
+---
+
+## 🏗️ Architecture
+
+```
+FarmHero (Next.js 15, TypeScript)
+├── app/
+│   ├── page.tsx              — Game state machine (welcome → region → dashboard → results)
+│   └── layout.tsx            — Root layout
+├── components/
+│   ├── farm-dashboard.tsx    — Main gameplay loop
+│   ├── farm-map.tsx          — 9-plot grid visualization
+│   ├── crop-selector.tsx     — Crop choice UI
+│   ├── resource-panel.tsx    — Water / nutrients / money / sustainability
+│   ├── season-report.tsx     — End-of-season review
+│   ├── phenology-display.tsx — NASA-driven crop stage visualization
+│   ├── region-selection.tsx  — Climate zone selection
+│   └── ...                   — irrigation, livestock, nitrogen, tooltips
+├── types/
+│   ├── region.ts             — Regional definitions
+│   └── crops.ts              — Crop types and seasons
+└── lib/
+    └── utils.ts
+```
+
+---
+
+## 🚀 Run Locally
+
+**Prerequisites:** Node.js 18+ · pnpm (or npm)
+
+```bash
+git clone https://github.com/Repetto-A/FarmHero.git
+cd FarmHero
+pnpm install
+pnpm dev
+# Open http://localhost:3000
+```
+
+```bash
+pnpm build   # Production build
+pnpm start   # Production server
+```
+
+---
+
+## 🏆 Hackathon Story
+
+FarmHero was built in 48 hours at **NASA Space Apps Challenge 2025** in Rosario, Argentina.
+
+- 🥇 **Won the Rosario local event** — selected as the top project
+- 🌍 **Global Nominee** — advanced to the worldwide round
+- 🎯 **Challenge:** Farm Navigators — NASA Data Exploration in Agriculture
+- 📋 [See the full presentation](./Presentacion%20.pdf)
+
+The core insight: agricultural education doesn't require expensive tools. A well-designed browser simulation using real satellite data can teach sustainable farming decisions to anyone with a smartphone.
+
+---
+
+## 🤝 Team
+
+Built at NASA Space Apps Rosario 2025. See [presentation PDF](./Presentacion%20.pdf) for full team credits.
+
+---
+
+## 📄 License
+
+MIT — see [LICENSE](./LICENSE) for details.
+
+---
+
+<div align="center">
+
+**⭐ Star this repo if FarmHero inspired you!**
+
+[Live Demo](https://farmhero-sepia.vercel.app) · [NASA Space Apps](https://www.spaceappschallenge.org/) · [Report an issue](https://github.com/Repetto-A/FarmHero/issues)
+
+</div>