diff --git a/README.md b/README.md
new file mode 100644
index 0000000..2d4b12a
--- /dev/null
+++ b/README.md
@@ -0,0 +1,29 @@
+# Task Manager API
+
+A REST API built with Spring Boot for managing tasks.
+
+## Tech Stack
+
+- Java 21 / Spring Boot 4
+- Spring Data JPA + H2 Database
+- Spring Security (HTTP Basic)
+- JUnit 5
+
+## Endpoints
+
+| Method | URL | Description |
+|--------|-----|-------------|
+| GET | /api/tasks | Get all tasks |
+| GET | /api/tasks/{id} | Get task by ID |
+| POST | /api/tasks | Create a task |
+| PUT | /api/tasks/{id} | Update a task |
+| DELETE | /api/tasks/{id} | Delete a task |
+
+## Run locally
+```bash
+git clone https://git.deklab.dev/dek/task-manager.git
+cd task-manager
+./mvnw spring-boot:run
+```
+
+Default credentials: `admin` / `admin`
\ No newline at end of file