diff --git a/README.md b/README.md
index ee93b73..5e895cf 100644
--- a/README.md
+++ b/README.md
@@ -1,10 +1,31 @@
# Code Brew
+
+
[](https://github.com/crafter-station)
+[](https://nextjs.org)
+[](https://www.typescriptlang.org/)
+[](https://tailwindcss.com/)
+[]()
**Monthly meetups for software engineers, designers, founders, and tech professionals across Latin America and Spain.**
-Visit the live site at [codebrew.tech](https://codebrew.tech)
+[Visit Website](https://codebrew.tech) โข [Partnership Deck](https://codebrew.tech/deck) โข [Join Community](https://crafters.chat/)
+
+
+
+---
+
+## ๐ Features
+
+- **๐ Interactive 3D Globe** - Explore Code Brew cities with an interactive globe powered by COBE
+- **๐ Live Stats** - Real-time GitHub stars and community metrics
+- **๐จ Modern Design System** - Void black + signal red brutalist design language
+- **๐ฑ Fully Responsive** - Optimized for all devices from mobile to desktop
+- **๐ญ Partnership Deck** - Interactive slide deck with keyboard and touch navigation
+- **โก Performance** - Built with Next.js 16 App Router for optimal speed
+- **๐ฌ Smooth Animations** - Powered by Motion for delightful interactions
+- **โฟ Accessible** - Following web accessibility best practices
---
@@ -98,27 +119,93 @@ npm start
npm run lint
```
+### Asset Generation
+
+Generate brand assets (OG images, favicon):
+
+```bash
+bun scripts/generate-assets.ts
+```
+
+This creates:
+- `public/og.png` (1200ร630 Open Graph image)
+- `public/og-twitter.png` (1200ร600 Twitter card)
+- `app/favicon.ico` (multi-size icon: 16, 32, 48px)
+
+---
+
+## Deployment
+
+This project is optimized for deployment on [Vercel](https://vercel.com):
+
+[](https://vercel.com/new/clone?repository-url=https://github.com/crafter-station/codebrew.tech)
+
+The site automatically deploys on push to the main branch. No environment variables are required for basic deployment.
+
---
## Project Structure
```
codebrew.tech/
-โโโ app/ # Next.js app directory
-โ โโโ page.tsx # Home page
-โ โโโ deck/ # Partnership deck
-โ โโโ layout.tsx # Root layout
-โโโ components/ # React components
-โ โโโ globe.tsx # Interactive 3D globe
-โ โโโ footer.tsx # Footer component
-โ โโโ ...
-โโโ public/ # Static assets
-โโโ lib/ # Utilities
-โโโ scripts/ # Build scripts
+โโโ app/ # Next.js app directory
+โ โโโ page.tsx # Landing page with hero, stats, events
+โ โโโ deck/ # Partnership deck presentation
+โ โ โโโ page.tsx # Interactive slide deck
+โ โโโ layout.tsx # Root layout with metadata
+โ โโโ globals.css # Global styles & design system
+โ โโโ favicon.ico # Generated favicon
+โโโ components/ # React components
+โ โโโ globe.tsx # Interactive 3D globe (COBE)
+โ โโโ footer.tsx # Footer with link columns
+โ โโโ github-badge.tsx # Live GitHub star counter
+โ โโโ logos/ # SVG logo components
+โ โโโ crafter-station.tsx
+โ โโโ github.tsx
+โโโ lib/
+โ โโโ utils.ts # Tailwind class merge utility
+โโโ public/ # Static assets
+โ โโโ og.png # Open Graph image
+โ โโโ og-twitter.png # Twitter card image
+โ โโโ *.svg # Icon assets
+โโโ scripts/
+โ โโโ generate-assets.ts # Brand asset generator
+โโโ package.json # Dependencies & scripts
+โโโ tsconfig.json # TypeScript configuration
+โโโ next.config.ts # Next.js configuration
+โโโ postcss.config.mjs # PostCSS with Tailwind
+โโโ eslint.config.mjs # ESLint configuration
```
---
+## Design System
+
+Code Brew uses a custom brutalist design system with the following principles:
+
+### Color Palette
+- **Void Black** (`#0A0A0A`) - Background
+- **Signal Red** (`#D42B2B`) - Primary accent
+- **Void White** (`#E5E5E5`) - Foreground text
+- **Muted Gray** (`#6B6B6B`) - Secondary text
+- **Border** (`#2A2A2A`) - Structural elements
+
+### Key Components
+- **Grid Overlay** - Technical blueprint aesthetic
+- **Corner Brackets** - Architectural framing
+- **Diamond Markers** - Navigation & emphasis
+- **Calibration Ticks** - Precision detail
+- **Film Grain** - Analog texture
+- **Ghost Text** - Large background typography
+
+### Typography
+- **Headings**: Geist Sans (system font fallback)
+- **Body & UI**: Geist Mono (monospace)
+- Responsive sizing with clamp()
+- Uppercase tracking for labels
+
+---
+
## Contributing
We welcome contributions! If you'd like to improve the Code Brew website:
@@ -131,24 +218,46 @@ We welcome contributions! If you'd like to improve the Code Brew website:
---
-## Join the Community
+## ๐ค Join the Community
+
+
-- **Website**: [codebrew.tech](https://codebrew.tech)
-- **Discord**: [crafters.chat](https://crafters.chat/)
-- **GitHub**: [@crafter-station](https://github.com/crafter-station)
+| Platform | Link |
+|----------|------|
+| ๐ **Website** | [codebrew.tech](https://codebrew.tech) |
+| ๐ฌ **Discord** | [crafters.chat](https://crafters.chat/) |
+| ๐ **GitHub** | [@crafter-station](https://github.com/crafter-station) |
+| ๐ฑ **WhatsApp** | [Contact us](https://wa.me/51912851377?text=Hi!%20I'm%20interested%20in%20Code%20Brew) |
+
+
---
-## Partnership
+## ๐ค Partnership
+
+Interested in sponsoring or partnering with Code Brew?
-Interested in sponsoring or partnering with Code Brew? View our [partnership deck](/deck) or reach out through [crafters.chat](https://crafters.chat/).
+- ๐ฏ View our [partnership deck](https://codebrew.tech/deck)
+- ๐ผ Contact us via [WhatsApp](https://wa.me/51912851377?text=Hi!%20I'm%20interested%20in%20partnering%20with%20Code%20Brew)
+- ๐ฌ Join the community at [crafters.chat](https://crafters.chat/)
+
+### Partnership Tiers
+- **Venue Partner**: Host our monthly event with guaranteed foot traffic
+- **Sponsor**: Logo placement across all event materials
+- **Exclusive Partner**: Co-branding and deep community integration
---
-## License
+## ๐ License
This project is maintained by [Crafter Station](https://github.com/crafter-station).
---
-**Est. 2024** ยท Built with care for the tech community
+
+
+**Est. 2024** ยท Built with โค๏ธ for the tech community
+
+[๐ Back to top](#code-brew)
+
+