diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..42c9105
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,11 @@
+# .NET build artifacts
+bin/
+obj/
+*.user
+*.suo
+.vs/
+.idea/
+
+# OS files
+.DS_Store
+Thumbs.db
diff --git a/README.md b/README.md
index 3daa7bd..569af3f 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,24 @@
-# calorie-tracker
+# CalorieTracker
 
-CalorieTracker - Blazor WASM + API calorie tracking app
\ No newline at end of file
+Blazor WASM + API calorie tracking application.
+
+## Project Structure
+
+```
+src/
+  CalorieTracker.Client/   # Blazor WASM frontend
+  CalorieTracker.Api/      # .NET Web API backend
+```
+
+## CI/CD
+
+Pushes to `main` or `develop` trigger automatic builds via Forgejo Actions.
+Merges to `main` trigger automatic deploy to hosting.
+
+## Getting Started
+
+```bash
+dotnet restore
+dotnet build
+dotnet test
+```