diff --git a/LICENSE b/LICENSE
index 261eeb9..d645695 100644
--- a/LICENSE
+++ b/LICENSE
@@ -1,3 +1,4 @@
+
Apache License
Version 2.0, January 2004
http://www.apache.org/licenses/
diff --git a/README.md b/README.md
index f46dacc..f7cdb39 100644
--- a/README.md
+++ b/README.md
@@ -1 +1,157 @@
-# agama-passkey
\ No newline at end of file
+# Agama Passkey Project
+
+
+[![Contributors][contributors-shield]][contributors-url]
+[![Forks][forks-shield]][forks-url]
+[![Stargazers][stars-shield]][stars-url]
+[![Issues][issues-shield]][issues-url]
+[![Apache License][license-shield]][license-url]
+
+Use this project to authenticate using security devices (Android Touch, iOS Face Id, Yubico Key, Windows Hello, Touch ID on Mac, etc.)
+
+## How it works at a glance
+
+When a main flow of this project is launched (namely `org.gluu.agama.passkey.main`) the user's browser is
+redirected to a view where he/she must first enter your username and password, then show a list of passkeys that you have
+registered, in case you do not have one you must register one, once you have registered your passkey you can complete
+the authentication step with passkey.
+But you can also log in from the initial screen without entering a c redential.
+
+## Project Deployment
+
+To deploy this project we need to meet the requirements.
+
+### Requirements
+
+1. Running instance of `Jans Auth Server`, `Jans Fido2`, `Jans Casa` and `Jans Scim`
+
+### Add Java dependencies
+
+1. Download
+ latest [agama-passkey-custom.jar](https://github.com/GluuFederation/agama-passkey/releases/latest/download/agama-passkey-custom.jar)
+ from [Releases](https://github.com/GluuFederation/agama-passkey/releases)
+2. `scp` the jar file to `/opt/jans/jetty/jans-auth/custom/libs/` on Auth Server
+3. On Auth Server, edit `/opt/jans/jetty/jans-auth/webapps/jans-auth.xml` and
+ add the jar file to the `...` element. For example:
+
+```
+
+ /jans-auth
+
+ /jans-auth.war
+
+ true
+
+ ...
+ /opt/jans/jetty/jans-auth/custom/libs/agama-passkey-custom.jar,
+ ...
+
+
+```
+
+4. Restart Auth Server to load the new jar:
+
+```
+systemctl restart jans-auth
+````
+
+### Deployment
+
+Download the
+latest [agama-passkey.gama](https://github.com/GluuFederation/agama-passkey/releases/latest/download/agama-passkey.gama)
+file and deploy it in Auth Sever.
+
+Follow the steps below:
+
+- Copy (SCP/SFTP) the gama file of this project to a location in your `Jans Server`
+- Connect (SSH) to your `Jans Server` and open TUI: `python3 /opt/jans/jans-cli/jans_cli_tui.py`
+- Navigate to the `Agama` tab and then select `"Upload project"`. Choose the gama file
+- Wait for about one minute and then select the row in the table corresponding to this project
+- Press `d` and ensure there were not deployment errors
+- Pres `ESC` to close the dialog
+
+
+
+### Configure Jans Scim
+
+- Once we have deployed the `agama project`, we need to configure the `jans scim` parameters, then we proceed to create a new user `jans scim` with scope `https://jans.io/scim/fido2.read` and `https://jans.io/scim/fido2.write`.
+- Now that we have the jans scim client, we proceed to configure this client using TUI.
+- We open TUI and we are located in agama, we select in the table where our application is deployed and press `c`, this will open a configuration panel, where we must first hit `Export Sample Config` and save the file in some path.
+- Now we go to the exported file and edit it and enter the credentials
+
+```
+{
+ "org.gluu.agama.passkey.add": {},
+ "org.gluu.agama.passkey.nickname": {},
+ "org.gluu.agama.passkey.list": {},
+ "org.gluu.agama.passkey.main": {
+ "scimClientId": "YOUR_SCIM_CLIENT_ID",
+ "scimClientSecret": "YOUR_SCIM_CLIENT_SECRET"
+ }
+}
+```
+
+- We go back to the TUI and click on `Import Configuration` and select the modified configuration file with our parameters.
+- With this, our `agama project` is now configured and we can start testing.
+
+
+
+## Testing
+
+You'll need an OpenID Connect test RP. You can try [oidcdebugger](https://oidcdebugger.com/),
+[jans-tarp](https://github.com/JanssenProject/jans/tree/main/demos/jans-tarp)
+or [jans-tent](https://github.com/JanssenProject/jans/tree/main/demos/jans-tent). Check out this video to see an example
+of **agama-passkey** in action:
+
+### Use case 1:
+
+Login with credentials and configure your first passkey device and as a last step complete the login with your new configured key.
+
+
+
+### Use case 2:
+
+Log in without credentials, use the `Login with passkey` button.
+
+
+
+
+# Contributors
+
+
+ 
+