diff --git a/README.md b/README.md
index 3c90943..10e52ed 100644
--- a/README.md
+++ b/README.md
@@ -1,7 +1,35 @@
-# ame
-rust rework
+<p align="center">
+  <a href="https://github.com/crystalux-project">
+    <img src="https://github.com/crystalux-project/branding/blob/main/crystalux-logo-minimal.png?" alt="Logo" width="150" height="150">
+  </a>
+</p>
+<p align="center"> 
+<h2 align="center"> Amethyst - Rust rework</h2>
+</p>
+<p align="center">
+<img src=https://img.shields.io/github/stars/crystalux-project/ame?style=flat&color=a900ff />
+<img src=https://img.shields.io/github/forks/crystalux-project/ame?style=flat&color=a900ff />
+<img src=https://img.shields.io/github/issues/crystalux-project/ame?style=flat&color=a900ff />
+<img src=https://img.shields.io/github/issues-pr/crystalux-project/ame?style=flat&color=a900ff />
+<a href="https://discord.gg/yp4xpZeAgW"><img alt="Discord" src="https://img.shields.io/discord/825473796227858482?color=blue&label=Discord&logo=Discord&logoColor=white"?link=https://discord.gg/yp4xpZeAgW&link=https://discord.gg/yp4xpZeAgW> </p></a>
 
-## to build:
+<p align="center"> amethyst is a fast, efficient and lightweight aur helper and pacman wrapper. 
+Made for crystalux, compatible with any arch-based linux distribution. <b>NOW IN RUST!</b></p>
+
+![](screenshot.png)
+
+## Basic usage - <b>NOT COMPLETE!</b>
+| Action | Command | Shorthand alias | Supported pacman equivalent |
+| ------ | ------ | ------ | ------ |
+| Install a package | amethyst install | ame ins | -S |
+| Remove a package| amethyst remove | ame rm | -R |
+| Update repository | amethyst update | ame upd | -Sy |
+| Upgrade a package | amethyst upgrade | ame upg | -Syu |
+| Search for a package in repo and aur | amethyst search | ame sear | -Ss |
+| Search for a package in repo | amethyst search -R | ame sear -R | -Ss -R |
+| Search for a package in aur | amethyst search -A | ame sear -A | -Ss -A |
+
+## How to build:
 
 for release
   - `make clean release`