diff --git a/.gitattributes b/.gitattributes
new file mode 100644
index 0000000..9bad8f4
--- /dev/null
+++ b/.gitattributes
@@ -0,0 +1 @@
+"README.md merge=ours" 
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..c68d181
--- /dev/null
+++ b/README.md
@@ -0,0 +1,70 @@
+# 
+
+Archives containing JAR files are available as [releases](https://github.com/intisy/java-utils/releases).
+
+## What is java-utils?
+
+
+
+## Usage in private projects
+
+ * Maven (inside the  file)
+```xml
+  <repository>
+      <id>github</id>
+      <url>https://maven.pkg.github.com/intisy/java-utils</url>
+      <snapshots><enabled>true</enabled></snapshots>
+  </repository>
+  <dependency>
+      <groupId>io.github.intisy</groupId>
+      <artifactId>java-utils</artifactId>
+      <version>2.0.7.2</version>
+  </dependency>
+```
+
+ * Maven (inside the  file)
+```xml
+  <servers>
+      <server>
+          <id>github</id>
+          <username>your-username</username>
+          <password>your-access-token</password>
+      </server>
+  </servers>
+```
+
+ * Gradle (inside the  or  file)
+```groovy
+  repositories {
+      maven {
+          url "https://maven.pkg.github.com/intisy/java-utils"
+          credentials {
+              username = "<your-username>"
+              password = "<your-access-token>"
+          }
+      }
+  }
+  dependencies {
+      implementation 'io.github.intisy:java-utils:2.0.7.2'
+  }
+```
+
+## Usage in public projects
+
+ * Gradle (inside the  or  file)
+```groovy
+  plugins {
+      id "io.github.intisy.github-gradle" version "1.3.7"
+  }
+  dependencies {
+      githubImplementation "intisy:java-utils:2.0.7.2"
+  }
+```
+
+Once you have it installed you can use it like so:
+
+
+
+## License
+
+[![Apache License 2.0](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](LICENSE)