diff --git a/README.md b/README.md
new file mode 100644
index 0000000..d9609c7
--- /dev/null
+++ b/README.md
@@ -0,0 +1,137 @@
+# AuthInbox
+
+**AuthInbox** is an open-source project designed to securely manage and view authentication emails. It automatically processes incoming emails, extracts verification codes or links, stores them in a database, and provides a user-friendly web interface for administrators to review the extracted information. Additionally, AuthInbox can send notifications via Bark, enhancing real-time alert capabilities.
+
+---
+
+## Table of Contents
+
+- [Features](#features)
+- [Technologies Used](#technologies-used)
+- [Installation](#installation)
+- [License](#license)
+- [Screenshots](#Screenshots)
+
+---
+
+## Features
+
+- **Email Processing**: Automatically captures and stores incoming emails.
+- **Code Extraction**: Utilizes AI to extract verification codes, links, and organization names from emails.
+- **Secure Front-End**: Provides a web interface protected by Basic Access Authentication for viewing extracted codes.
+- **Real-Time Notifications**: Optionally sends notifications via Bark when new codes are extracted.
+- **Database Integration**: Stores raw and processed email data in a D1Database.
+
+---
+
+## Technologies Used
+
+- **Cloudflare Workers**: Serverless platform for handling email processing and web requests.
+- **D1Database**: Cloudflare's serverless SQL database for storing email data.
+- **TypeScript**: Strongly typed programming language for robust and maintainable code.
+- **Google AI API**: Utilized for extracting relevant information from emails.
+- **Bark API**: Optional integration for sending real-time notifications.
+- **HTML/CSS**: Front-end interface with responsive and modern design.
+- **Google Fonts**: Enhances the visual appeal of the web interface with consistent typography.
+
+---
+
+## Installation
+0. **Prerequisites**
+
+   Install [Wrangler](https://developers.cloudflare.com/workers/wrangler/get-started/)
+   ```bash
+   npm install wrangler -g
+   ```
+   Create a [Google AI API](https://aistudio.google.com/)
+   Have a domain binded on your [Cloudflare](https://dash.cloudflare.com/) account
+
+2. **Initialization**
+
+   ```bash
+   git clone https://github.com/TooonyChen/AuthInbox.git
+   cd AuthInbox
+   npm install
+   ```
+
+3. **create d1 database**
+
+   When you execute the [Wrangler](https://developers.cloudflare.com/workers/wrangler/get-started/) login command for the first time, you will be prompted to log in. Just follow the prompts.
+
+   ```bash
+   npx wrangler d1 execute inbox-d1 --local --file=./schema.sql # creating a d1 database called 'inbox-d1'
+   ```
+   you will get the result like this:
+   ```bash
+   ✅ Successfully created DB 'inbox-d1'
+
+   [[d1_databases]]
+   binding = "DB" # available in your Worker on env.DB
+   database_name = "inbox-d1"
+   database_id = "<unique-ID-for-your-database>"
+   ```
+   please copy the result from your terminal, you will use them in the next step
+
+4. **Configure Environment Variables**
+
+Use `wrangler.toml` file in the project root with the necessary environment variables:
+
+   ```toml
+   name = "auth-inbox"
+   type = "typescript"
+   
+   [vars]
+   UseBark = 'true' # set 'true' to use or 'false' to not use
+   barkUrl = "https://api.day.app"
+   barkTokens = 'xxxxxxxxx' # set to your bark tokens on your iOS device
+   FrontEndAdminID = 'admin' # your login
+   FrontEndAdminPassword = 'password' # your password
+   GoogleAPIKey = 'xxxxxxxxxxx' # your google api, go to https://aistudio.google.com/ to generate one if u dont have
+
+   [[d1_databases]] # Copy the lines obtained from step 2 from your terminal.
+   binding = "DB"
+   database_name = "inbox-d1" # Copy from step 2
+   database_id = "<unique-ID-for-your-database>" # Copy from step 2
+   ```
+4. **Deploy your own worker**
+   Deploy your Worker to make your project accessible on the Internet. Run:
+   ```bash
+   npx wrangler deploy
+   ```
+   You will get output like this:
+   ```
+   Outputs: https://inbox-d1.<YOUR_SUBDOMAIN>.workers.dev
+   ```
+   You can now visit the URL for your newly depolyed auth inbox for checking the email results.
+5. **Set Email Forwarding**
+   Go to [Cloudflare Dashboard](https://dash.cloudflare.com/) -> `Websites` -> `<your-domain>` -> `Email` -> `Email-Routing` -> `Routing Rules`
+   if you want to use `catch-all address`:
+   ![image](https://github.com/user-attachments/assets/53e5a939-6b03-4ca6-826a-7a5f02f361ac)
+   if you want to use `custom address`:
+   ![image](https://github.com/user-attachments/assets/b0d0ab94-c2ad-4870-ac08-d53e64b2c880)
+6. **Done**
+   All set! Try it now!
+
+   
+---
+
+## License
+
+This project is licensed under the [MIT License](LICENSE).
+
+---
+
+## Screenshots
+
+![image](https://github.com/user-attachments/assets/2a93c9a7-0fd9-404b-9bce-83a458f1c66e)
+
+---
+
+## Acknowledgements
+
+- **Cloudflare Workers** for providing a powerful serverless platform.
+- **Google Gemini AI** for enabling intelligent email content extraction.
+- **Bark** for real-time notification capabilities.
+- **Open Source Community** for inspiring and supporting projects like AuthInbox.
+
+---