From feaa5f142a16bad1b466ef24d92352b45f7343dc Mon Sep 17 00:00:00 2001
From: Kirubel-Kibru-Yaltopia <kirubeljkl679@gmail.com>
Date: Sun, 24 May 2026 21:45:40 +0300
Subject: [PATCH] first commit

---
 README.md | 69 +++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 69 insertions(+)
 create mode 100644 README.md

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..fa160c7
--- /dev/null
+++ b/README.md
@@ -0,0 +1,69 @@
+# Yaltopia FIFA
+
+FIFA tournament platform by [Yaltopia Tech](https://yaltopia.com) — leagues, cups, fixtures, standings, and team management.
+
+## Stack
+
+- **Next.js 15** (App Router) + **TypeScript**
+- **Supabase** (Auth, Postgres, RLS)
+- **Tailwind CSS 4** + **shadcn/ui**
+- **Cloudflare** deploy via OpenNext (`@opennextjs/cloudflare`)
+
+## Portals
+
+| Portal | Login | Home |
+|--------|-------|------|
+| Team Manager (public) | `/login/manager` | `/manager` |
+| League Master (hidden) | `/login/master` | `/master` |
+
+See [docs/LEAGUE_MASTER_ACCESS.md](docs/LEAGUE_MASTER_ACCESS.md) for master URLs and signup notes.
+
+## Quick start
+
+```bash
+npm install
+cp .env.example .env.local   # if present; otherwise create .env.local
+npm run dev
+```
+
+`.env.local` (minimum):
+
+```env
+NEXT_PUBLIC_SUPABASE_URL=https://YOUR_REF.supabase.co
+NEXT_PUBLIC_SUPABASE_ANON_KEY=eyJ...
+```
+
+Optional (dev signup / admin tools):
+
+```env
+SUPABASE_SERVICE_ROLE_KEY=eyJ...
+SUPABASE_AUTO_CONFIRM_EMAIL=true
+```
+
+Apply database migrations:
+
+```bash
+npm run db:push
+```
+
+Open [http://localhost:3000](http://localhost:3000).
+
+## Scripts
+
+| Command | Description |
+|---------|-------------|
+| `npm run dev` | Local dev server |
+| `npm run build` | Production build |
+| `npm run db:push` | Push Supabase migrations |
+| `npm run deploy` | Build + deploy to Cloudflare |
+| `npm run auth:reset-password -- email pass` | Dev password reset (service role) |
+
+## Docs
+
+- [Cloudflare deploy](docs/CLOUDFLARE_DEPLOY.md)
+- [League Master access](docs/LEAGUE_MASTER_ACCESS.md)
+- [Password reset & rate limits](docs/PASSWORD_RESET.md)
+
+## License
+
+Private — Yaltopia Tech.