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
+
+
+# ๐พ FarmHero
+
+**NASA Space Apps Challenge 2025 โ Rosario Winner ๐ & Global Nominee ๐**
+
+[](https://farmhero-sepia.vercel.app)
+[](https://www.spaceappschallenge.org/)
+[](https://nextjs.org/)
+[](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)
+
+
+
+---
+
+## ๐ 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.
+
+---
+
+
+
+**โญ 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)
+
+