diff --git a/readme.md b/readme.md
new file mode 100644
index 0000000..c65ee52
--- /dev/null
+++ b/readme.md
@@ -0,0 +1,27 @@
+# release-hive back end
+[![Build Status](https://drone.beatrice.wtf/api/badges/bea/release-hive/status.svg)](https://drone.beatrice.wtf/bea/release-hive)
+[![Quality Gate Status](https://sonar.beatrice.wtf/api/project_badges/measure?project=relhive&metric=alert_status&token=sqb_4f7b91f9a42424c2435f3d14de1fe4654a3cab5d)](https://sonar.beatrice.wtf/dashboard?id=relhive)
+[![Reliability Rating](https://sonar.beatrice.wtf/api/project_badges/measure?project=relhive&metric=reliability_rating&token=sqb_4f7b91f9a42424c2435f3d14de1fe4654a3cab5d)](https://sonar.beatrice.wtf/dashboard?id=relhive)
+[![Security Rating](https://sonar.beatrice.wtf/api/project_badges/measure?project=relhive&metric=security_rating&token=sqb_4f7b91f9a42424c2435f3d14de1fe4654a3cab5d)](https://sonar.beatrice.wtf/dashboard?id=relhive)
+[![Maintainability Rating](https://sonar.beatrice.wtf/api/project_badges/measure?project=relhive&metric=sqale_rating&token=sqb_4f7b91f9a42424c2435f3d14de1fe4654a3cab5d)](https://sonar.beatrice.wtf/dashboard?id=relhive)
+
+
+*pure java software backend for software release management*  
+  
+## building  
+### required tools  
+   
+ - java 17+ sdk  
+ - git  
+ - maven  
+  
+### build steps  
+the build process currently happens with maven.
+specific build and release steps have not been specified yet.  
+  
+## support
+| category            | info                                                       |
+|---------------------|------------------------------------------------------------|
+| official repository | [gitea src](https://git.beatrice.wtf/bea/release-hive.git) |
+| build status        | [drone-ci](https://drone.beatrice.wtf/bea/release-hive)    |
+| dev email           | [hello@beatrice.wtf](mailto:hello@beatrice.wtf)            |