diff --git a/README.md b/README.md
index 8a7347b..2a7a632 100644
--- a/README.md
+++ b/README.md
@@ -1,12 +1,28 @@
-# ascii-animator
-[](https://github.com/soda480/ascii-animator/actions/workflows/main.yml)
-[](https://radon.readthedocs.io/en/latest/api.html#module-radon.complexity)
-[](https://pypi.org/project/bandit/)
-[](https://badge.fury.io/py/ascii-animator)
-[](https://www.python.org/downloads/)
-
-A simple ASCII text animator.
-
+
+
ascii-animator - A simple ASCII text animator
+
+
+
+

+
+
+
The `ascii-art-animator` CLI will take as input a GIF image, extract all the frames from it, convert each frame to ASCII art using [ascii-magic](https://pypi.org/project/ascii-magic/), then display each frame to the terminal using [list2term](https://pypi.org/project/list2term/).
### Installation
@@ -45,15 +61,17 @@ Use `ascii-art-animator` to convert the following GIF image to an ascii animatio
```bash
ascii-art-animator -f docs/images/marcovich.gif -a -m 3 -c 100
```
-**input**
+**GIF Input**

-**output**
+**Program Output**

-### `Animation` class
+---
+
+### The `Animation` class โญ
Use the Animation class to create your own animations.
@@ -89,27 +107,46 @@ A Matrix animation.
A Conway Game-Of-Life implementation that uses `ascii_animator` to display the game to the terminal.
-### Development
+---
+
+### Installation ๐
Clone the repository and ensure the latest version of Docker is installed on your development server.
-Build the Docker image:
+1) Build the Docker image:
```bash
docker image build \
-t ascii-animator:latest .
```
-Run the Docker container:
+2) Run the Docker container:
```bash
docker container run \
--rm \
-it \
-v $PWD:/code \
+
ascii-animator:latest \
bash
```
-Execute the build:
+3) Execute the build:
```sh
pyb -X
```
+
+---
+
+### ๐ Issues & Support
+
+Encounter a problem? Have a suggestion? Feel free to **open an issue** and include the following details:
+
+- โ
**Clear description** of the issue or feature request
+- ๐ ๏ธ **Steps to reproduce** (if applicable)
+- ๐ธ **Screenshots or logs** (if relevant)
+- ๐ก **Expected vs. actual behavior**
+
+Your feedback helps improve the projectโthank you for contributing! ๐
+
+
+