diff --git a/README.md b/README.md
new file mode 100644
index 0000000..d3a5051
--- /dev/null
+++ b/README.md
@@ -0,0 +1,39 @@
+# Birthday Roast Gallery
+
+A fun birthday meme website for roasting your friends with their best (worst) moments.
+
+## Development
+
+```bash
+npm install
+npm run dev
+```
+
+## Adding Photos
+
+1. Add images to `public/images/` folder
+2. Update `public/roasts.json` with image filenames and Vietnamese captions
+3. Rebuild and redeploy
+
+## Docker Build
+
+```bash
+docker build -t cmsn-b-linh:latest .
+```
+
+## Kubernetes Deployment
+
+1. Push image to your registry:
+```bash
+docker tag cmsn-b-linh:latest your-registry/cmsn-b-linh:latest
+docker push your-registry/cmsn-b-linh:latest
+```
+
+2. Update `k8s/deployment.yaml` with your registry image
+
+3. Apply manifests:
+```bash
+kubectl apply -f k8s/
+```
+
+4. Access at: https://cmsn-b-linh.duylai.duckdns.org