diff --git a/README.md b/README.md
new file mode 100644
index 0000000..ad6b729
--- /dev/null
+++ b/README.md
@@ -0,0 +1,14 @@
+## Uutissivusto - koulu projekti
+
+Golla ja Gin- frameworkilla toteutettu ylen tapainen uutissivusto. 
+
+- `main.go`, Reitit ja palvelimen käynnistys
+- `internal` sisäinen logiikka, https://github.com/golang-standards/project-layout/blob/master/internal/README.md
+- `internal/auth` autentikointi middleware ja kirjautuminen
+- `internal/database` tietokanta yhteydet ja queryt
+- `templates` HTML/tmpl mallit ja staattiset tiedostot 
+
+## Pyörittäiminen
+
+`go mod tidy` lataa riippuvuudet
+`go run main.go` käynnistää palvelimen paikallisesti porttiin 8080, mysql yhteydet pitää hoitaa `internal/database/connect.go` tiedostossa
\ No newline at end of file