diff --git a/README.md b/README.md
new file mode 100644
index 0000000..0edf97e
--- /dev/null
+++ b/README.md
@@ -0,0 +1,27 @@
+
Civilian Harm in Ukraine TimeMap
+
+
+
+
+
+
+ TimeMap is a tool for exploration, monitoring and classification of incidents in time and space, originally forked from forensic-architecture/timemap.
+
+
+
+
+
+
+## Development
+* Use **node v14.x.x**
+* `npm install` to setup
+* `cp example.config.js config.js` create config file
+* `CONFIG=config.js npm run dev` or `npm run dev` if the file is named config.js
+* For more info visit the [original repo](https://github.com/forensic-architecture/timemap)
+
+## Contributing
+Please check our [issues page](https://github.com/bellingcat/ukraine-timemap) for desired contributions, and feel free to suggest your own.
\ No newline at end of file
diff --git a/docs/example-timemap.png b/docs/example-timemap.png
index cffc8ed..3d97995 100644
Binary files a/docs/example-timemap.png and b/docs/example-timemap.png differ