diff --git a/README.md b/README.md
index 495e335..91610a8 100644
--- a/README.md
+++ b/README.md
@@ -1 +1,9 @@
-This is a frontend to display the job applications scraped by my sw-jobs-api deployd to ec2 and reachable at http://51.20.250.24/jobs
+# SW Jobs Frontend
+
+This is a frontend to display the job applications scraped my [sw-jobs-go](https://gitea.rannes.dev/rannes.dev/sw-jobs-go).
+
+## How to run
+
+1.  npm install
+2.  npm run dev or npm run build
+3.  open http://localhost:3000