diff --git a/README.md b/README.md
index e215bc4..98525fd 100644
--- a/README.md
+++ b/README.md
@@ -1,36 +1,79 @@
-This is a [Next.js](https://nextjs.org) project bootstrapped with [`create-next-app`](https://nextjs.org/docs/app/api-reference/cli/create-next-app).
+# Kovak Yazılım — Kurumsal Web Sitesi
 
-## Getting Started
+Next.js 16 + TypeScript + Tailwind v4 + Appwrite ile geliştirilmiş kurumsal site.
 
-First, run the development server:
+## Teknoloji
+
+- **Framework:** Next.js 16 (App Router, Turbopack, React 19)
+- **Stil:** Tailwind CSS v4
+- **Backend:** Appwrite (TablesDB) — `https://db.kovaksoft.com`
+- **İkonlar:** lucide-react + inline SVG brand icons
+- **Form:** React Server Actions + `useActionState`
+
+## Kurulum
 
 ```bash
+npm install
+cp .env.example .env.local
+# .env.local dosyasındaki APPWRITE_API_KEY'i Appwrite Console'dan oluşturup ekle
 npm run dev
-# or
-yarn dev
-# or
-pnpm dev
-# or
-bun dev
 ```
 
-Open [http://localhost:3000](http://localhost:3000) with your browser to see the result.
+Site: <http://localhost:3000>
 
-You can start editing the page by modifying `app/page.tsx`. The page auto-updates as you edit the file.
+## Appwrite Yapılandırması
 
-This project uses [`next/font`](https://nextjs.org/docs/app/building-your-application/optimizing/fonts) to automatically optimize and load [Geist](https://vercel.com/font), a new font family for Vercel.
+**Project ID:** `69f27b51000a5bee46ce`
+**Database ID:** `kovak-yazilim-db`
 
-## Learn More
+### Tablolar
 
-To learn more about Next.js, take a look at the following resources:
+| Tablo | İçerik | Yazma izni |
+|---|---|---|
+| `services` | Hizmetler (slug, title, description, icon, order, featured) | yalnız users |
+| `projects` | Referans projeler (slug, title, description, image_url, live_url, category, technologies[], year, featured) | yalnız users |
+| `contact_messages` | İletişim formu kayıtları (name, email, phone, subject, message, status) | herkes create, users read/update/delete |
 
-- [Next.js Documentation](https://nextjs.org/docs) - learn about Next.js features and API.
-- [Learn Next.js](https://nextjs.org/learn) - an interactive Next.js tutorial.
+`contact_messages.create` izni `any` — anonim kullanıcılar form gönderebilsin diye.
+Diğer tüm yazma işlemleri yetkili kullanıcı (admin) gerektirir.
 
-You can check out [the Next.js GitHub repository](https://github.com/vercel/next.js) - your feedback and contributions are welcome!
+### API Key Oluşturma
 
-## Deploy on Vercel
+1. Appwrite Console → Settings → API Keys → Create
+2. Scopes: `databases.read`, `tables.read`, `rows.read`, `rows.write`
+3. `.env.local` içine `APPWRITE_API_KEY=` olarak yapıştır
 
-The easiest way to deploy your Next.js app is to use the [Vercel Platform](https://vercel.com/new?utm_medium=default-template&filter=next.js&utm_source=create-next-app&utm_campaign=create-next-app-readme) from the creators of Next.js.
+## Yapı
 
-Check out our [Next.js deployment documentation](https://nextjs.org/docs/app/building-your-application/deploying) for more details.
+```
+app/
+  actions.ts          # Server Action: submitContact
+  layout.tsx          # Root layout + Header/Footer
+  page.tsx            # Anasayfa
+  hizmetler/          # /hizmetler
+  projeler/           # /projeler
+  hakkimizda/         # /hakkimizda
+  iletisim/           # /iletisim
+components/           # Header, Footer, Hero, ContactForm, …
+lib/
+  appwrite.ts         # Browser client
+  appwrite-server.ts  # Server client (uses APPWRITE_API_KEY)
+  data.ts             # listServices / listProjects (Server-only)
+  site-config.ts      # Marka, iletişim, fallback hizmetler
+  types.ts
+public/logo.png       # Logo (kovakyazilim.com'dan)
+```
+
+## Build
+
+```bash
+npm run build
+npm start
+```
+
+## Gitea Remote
+
+```bash
+git remote add origin ssh://git@git.kovaksoft.com:2222/kovakmedya/kovakyazilim.git
+git push -u origin main
+```