diff --git a/README.md b/README.md
new file mode 100644
index 0000000000000000000000000000000000000000..c3f4345f13aa7c9f4049b71dcc8e18f197314d39
--- /dev/null
+++ b/README.md
@@ -0,0 +1,14 @@
+# TETRAS PAGE DOKS
+
+this project is based on the works of [this repository](https://gitlab.com/epogrebnyak/doks-howto/-/blob/master/config/_default/config.toml?ref_type=heads)
+
+This project have for purpose to create a template. This template will be used by Tetras-libre projects and they will be share with the clients. It'll document the progress of the project in the blog part. The Doc part will be use as a tutorial for the client.
+## To run the project localy
+
+- clone this repo
+- run `npm run build`
+- run `npm run dev`
+
+## Adapt this template
+
+To adapt this template to suits your need please follow this [documentation](http://tetras-page-doks-tetras-libre-5399438f0911bada81a479452e0ef7aeb.pages.tetras-libre.fr/docs/set-up/getting-started/)