diff --git a/readme.md b/readme.md
new file mode 100644
index 0000000..b9c035d
--- /dev/null
+++ b/readme.md
@@ -0,0 +1,46 @@
+# XML Tools
+Content of this project is a service hosting tools for xml documents including xslt transformer,
+xpath selector and xsd validator.
+
+## About project
+Service is split into three microservices.
+1. JavaSpark web application serving REST API for XSD, XML, XSLT tools 
+2. Spring application serving REST mock service
+3. Nginx hosting static documents. 
+
+## JavaSpark backend
+Backend is hosted by default on port 8081. Rest api documentation is contained in OpenApi document
+openapi.yml
+
+Rest API accepts xml documents, given querry and processor version to call requested xml engine to perform given
+operation and finally returns outcome in response body.
+
+## Mocked services
+MockedServices is a tool that allows developer to create, in easy and simple way, http server mocked endpoints for integration tests
+
+## Frontend
+All the static files are available by default on port 8086 and are located within folder.
+
+To preview given document user is required to post GET request to following path:
+```aidl
+/Frontend/{document name}
+```
+Documents are hosted by docker container running on ngix image and to modify container content
+one must modify Dockerfile located in Frontend folder. Files published must be located in ngix directory
+within created container.
+
+## How to run
+
+### Localy
+In order to run application use
+```aidl
+docker-compose up --build -d
+```
+Which will launch service on localhost.
+
+### Remote
+To launch service on remote host, exchange ssh keys with destination server and declare docker context ex. DEV.
+Then use following command
+```aidl
+docker-compose up --context DEV --build -d 
+```