Update docs

Author: darixsamani

README.md

@@ -1,46 +1,68 @@
-# FastAPI Async Template with PostgreSQL
-
-This is a template for building **asynchronous FastAPI applications** with **PostgreSQL**.
-
-If you're looking to understand the project in depth, please refer to the full documentation here:  
-👉 [Deep Documentation](https://deepwiki.com/darixsamani/fastapi-postgres) and [Docker Hub Images](https://hub.docker.com/repository/docker/darixsamani/fastapipostgresql/general)
-
-
-# Features
- - Python FastAPI backend
- - POSTGRESQL Database
- - Docker-Compose
- - Authentification
- - Migration with Alembic
- - PGADMIN4 for Graphical Database Visualization
- - Asynchronous
- - Support SQLmodel
-
-## Here are the steps to follow to run the program: 
-After cloning the repository, go to it. 
- 1. DOCKER COMPOSE
-    ```
-    docker compose up -d --build
-    
-    ```
-
- 2. RUN FRIST MIGRATION
-      ```
-      docker compose exec app uv run alembic revision --autogenerate -m "first migration"
-      docker compose exec app uv run alembic upgrade head
-      ```
- 3. Please turn on the LISTEN Docs app. `0.0.0.0:8001/docs`
-
-
-
- 4. PGADMIN4
-   
-   access to pgadmin by specified db as name server and 5434 as port at localhost/5050
-   
-   username: [email protected]
-   password: admin
-
-   Please turn on the LISTEN Docs app. `0.0.0.0:5050`
- 
- 5. EXAMPLE
-    ![IMAGE](./img/img.png)
+# 🚀 FastAPI Async Template with PostgreSQL
+
+Welcome to the **FastAPI Async Template** — a clean and modern starter for building **asynchronous APIs** powered by **FastAPI** ⚡ and **PostgreSQL** 🐘.
+
+Dive deeper into the full project documentation here:  
+📚 [Deep Documentation](https://deepwiki.com/darixsamani/fastapi-postgres)  
+🐳 [Docker Hub Images](https://hub.docker.com/repository/docker/darixsamani/fastapipostgresql/general)
+
+---
+
+## ✨ Features
+
+✅ **FastAPI** — lightning-fast backend framework  
+🐘 **PostgreSQL** — robust and reliable database  
+📦 **Docker Compose** — easy setup and environment management  
+🔐 **Authentication** — secure user handling  
+⚙️ **Alembic** — smooth database migrations  
+🧠 **Async Support** — fully asynchronous stack  
+📊 **PGAdmin4** — visual database management  
+🧱 **SQLModel** — type-safe ORM integration  
+
+---
+
+## 🧭 Quick Start Guide
+
+Follow these simple steps to get your app running in no time ⏱️
+
+### 🐳 1. Start with Docker Compose
+
+```bash
+docker compose up -d --build
+```
+
+
+### 🔄 2. Run the First Migration
+
+Initialize and apply your first migration using Alembic 🚀
+
+```
+docker compose exec app uv run alembic revision --autogenerate -m "first migration"
+docker compose exec app uv run alembic upgrade head
+ ```
+
+### 🌐 3. Access the API Docs
+
+Open the FastAPI interactive docs at:
+👉 [http://0.0.0.0:8001/docs](http://0.0.0.0:8001/docs)
+
+
+
+### 🗂️ 4. PGAdmin4 Access
+
+Manage your PostgreSQL database visually via PGAdmin4 🎛️
+
+Access URL: [http://localhost:5050](http://localhost:5050)
+
+Server Name: `db`
+
+Port: `5434`
+
+Username: `[email protected]`
+
+Password: `admin`
+
+
+### 🧩 5. Example Preview
+
+ ![IMAGE](./img/img.png)