diff --git a/README.md b/README.md
index 247e7cf..40c81df 100644
--- a/README.md
+++ b/README.md
@@ -1,44 +1,124 @@
-# carecaoke
+
+ 
+
+Carecaokê
-This project uses Quarkus, the Supersonic Subatomic Java Framework.
+
+
+
+
+
+
+[](https://github.com/coppolaop/CarecaokeAPI/actions/workflows/maven.yml)
+
+[](https://github.com/coppolaop/CarecaokeAPI/releases)
+[](https://github.com/coppolaop/https://img.shields.io/github/license/CarecaokeAPI.svg/blob/main/LICENSE)
+
+## 📋 Table of Contents
+
+1. 🎙️ [About Carecaokê](#about)
+2. 🎉 [What is this API ?](#what-is-this-api)
+3. 🎵 [Features](#features)
+4. 🔨 [Development mode and Unit testing](#dev-and-tst)
+5. 🌿 [Env variables](#env-variables)
+6. 🐙 [GitHub Actions](#github-actions)
+7. ©️ [License](#license)
+8. ❤️ [Contributors](#contributors)
+
+
+
+## 🎙️ About
+
+When singing, some people feel like they are exposing part of their soul. I'm one of those people.
+In these moments, there is nothing more comforting than knowing that, in addition to enjoying singing, others enjoyed
+listening.
+Therefore, Carecaokê aims to not only bring this instant feedback but also enable a fun game between friends, in this
+special moment.
+Gather your friends, sing, be happy!
+
+> Hey now, you're an all star
+> Get your game on, go play
+> Hey now, you're a rock star
+> Get the show on, get paid
+> And all that glitters is gold
+> Only shooting stars break the mold
+> -- Smash Mouth - All Star
+
+Embrace singing competition!
+
+
+
+## 🎉 What is this API ?
+
+Carecaokê API provides over HTTP requests a way of manage the singing competition.
+
+It's a **Backend** application to support your competition.
+
+
+
+## 🎵 Features
+
+- Managing your party Guests
+- Managing all sung songs
+- Managing votes
+- Generate ratings
+- Listing all results
+- Controlling list of songs to sing and call the next song
+- Preventing singers from voting for themselves
+- Allowing guests to manage only their own music and votes
+
+
+## 🔨 Development mode and Unit testing
+
+This project uses Quarkus, the Supersonic Subatomic Java Framework.
If you want to learn more about Quarkus, please visit its website: https://quarkus.io/ .
+We suggest you configure your preferred Java IDE.
+Remember that you will also need to configure adapters for the **Quarkus** framework.
+For unit tests, we aim to ensure maximum coverage in the **controller** and **service** classes. Run them using your
+IDE.
-## Running the application in dev mode
+### Running the application in dev mode
You can run your application in dev mode that enables live coding using:
+
```shell script
./mvnw compile quarkus:dev
```
> **_NOTE:_** Quarkus now ships with a Dev UI, which is available in dev mode only at http://localhost:8080/q/dev/.
-## Packaging and running the application
+### Packaging and running the application
The application can be packaged using:
+
```shell script
./mvnw package
```
+
It produces the `quarkus-run.jar` file in the `target/quarkus-app/` directory.
Be aware that it’s not an _über-jar_ as the dependencies are copied into the `target/quarkus-app/lib/` directory.
The application is now runnable using `java -jar target/quarkus-app/quarkus-run.jar`.
If you want to build an _über-jar_, execute the following command:
+
```shell script
./mvnw package -Dquarkus.package.type=uber-jar
```
The application, packaged as an _über-jar_, is now runnable using `java -jar target/*-runner.jar`.
-## Creating a native executable
+### Creating a native executable
+
+You can create a native executable using:
-You can create a native executable using:
```shell script
./mvnw package -Dnative
```
-Or, if you don't have GraalVM installed, you can run the native executable build in a container using:
+Or, if you don't have GraalVM installed, you can run the native executable build in a container using:
+
```shell script
./mvnw package -Dnative -Dquarkus.native.container-build=true
```
@@ -47,24 +127,60 @@ You can then execute your native executable with: `./target/carecaoke-1.0.0-SNAP
If you want to learn more about building native executables, please consult https://quarkus.io/guides/maven-tooling.
-## Related Guides
+### Related Guides
-- Hibernate ORM ([guide](https://quarkus.io/guides/hibernate-orm)): Define your persistent model with Hibernate ORM and Jakarta Persistence
+- Hibernate ORM ([guide](https://quarkus.io/guides/hibernate-orm)): Define your persistent model with Hibernate ORM and
+ Jakarta Persistence
- JDBC Driver - H2 ([guide](https://quarkus.io/guides/datasource)): Connect to the H2 database via JDBC
-- RESTEasy Reactive ([guide](https://quarkus.io/guides/resteasy-reactive)): A Jakarta REST implementation utilizing build time processing and Vert.x. This extension is not compatible with the quarkus-resteasy extension, or any of the extensions that depend on it.
+- RESTEasy Reactive ([guide](https://quarkus.io/guides/resteasy-reactive)): A Jakarta REST implementation utilizing
+ build time processing and Vert.x. This extension is not compatible with the quarkus-resteasy extension, or any of the
+ extensions that depend on it.
+
+
+
+## 🌿 Env variables
+
+Environnement variables are available in a secret file at folder
+**[resources](https://github.com/coppolaop/CarecaokeAPI/tree/main/src/main/resources)**.
+File name must be **secret.properties**.
+
+Environment variables are :
+
+| Name | Description | Required |
+|:-----------------------------:|:---------------------------------:|:--------:|
+| `quarkus.datasource.username` | Your database credential username | ✅ |
+| `quarkus.datasource.password` | Your database credential password | ✅ |
+
+
+
+## 🐙 GitHub Actions
+
+This project uses **GitHub Actions** to automate some tasks and reduce toil.
+
+You can find all the workflows in the
+**[.github/workflows directory](https://github.com/coppolaop/CarecaokeAPI/tree/main/.github/workflows).**
-## Provided Code
+### 🎢 Workflows
-### Hibernate ORM
+| Name | Description & Status | Triggered on |
+|:-------------------------------------------------------------------------------------:|:---------------------------------------------:|:------------------------------------------------------:|
+| **[⚙️ Build](https://github.com/coppolaop/CarecaokeAPI/actions/workflows/maven.yml)** | Build the application and runs all Unit Tests | `push` on `develop` and all pull requests to `develop` |
-Create your first JPA entity
+
-[Related guide section...](https://quarkus.io/guides/hibernate-orm)
+## ©️ License
+This project is licensed under the [Apache License, Version 2.0](https://opensource.org/license/apache-2-0).
+
-### RESTEasy Reactive
+## ❤️ Contributors
-Easily start your Reactive RESTful Web Services
+
+
+
+
+
+
-[Related guide section...](https://quarkus.io/guides/getting-started-reactive#reactive-jax-rs-resources)
+
\ No newline at end of file
diff --git a/assets/img/carecaoke.png b/assets/img/carecaoke.png
new file mode 100644
index 0000000..f4419d9
Binary files /dev/null and b/assets/img/carecaoke.png differ