diff --git a/readme.md b/readme.md
index 3858d8e..7d855d2 100755
--- a/readme.md
+++ b/readme.md
@@ -1,20 +1,112 @@
-# Astro Tailwind Boilerplate
+# Astro + Tailwind CSS + TypeScript Starter and Boilerplate
+<p align=center>Astroplate is a free starter template built with Astro, TailwindCSS & TypeScript, providing everything you need to jumpstart your Astro project and save valuable time.</p>
 
-## Dependency
+<p align=center> Made with ♥ by <a href="https://zeon.studio/"/> Zeon Studio </a> </a>
+</p>
+
+<h2 align="center"> <a target="_blank" href="https://astroplate.netlify.app/" rel="nofollow">Demo</a> | <a  target="_blank" href="https://pagespeed.web.dev/analysis/https-astroplate-netlify-app/utpbxg4qlk?form_factor=desktop">Page Speed (100%)</a>
+</h2>
+
+
+<p align=center>
+  <a href="https://github.com/withastro/astro/releases/tag/astro%402.0.11" alt="Contributors">
+    <img src="https://img.shields.io/static/v1?label=ASTRO&message=2.0&color=000&logo=astro" />
+  </a>
+
+  <a href="https://github.com/zeon-studio/astroplate/blob/main/LICENSE">
+    <img src="https://img.shields.io/github/license/zeon-studio/astroplate" alt="license"></a>
+
+  <img src="https://img.shields.io/github/languages/code-size/zeon-studio/astroplate" alt="code size">
+
+  <a href="https://github.com/zeon-studio/astroplate/graphs/contributors">
+    <img src="https://img.shields.io/github/contributors/zeon-studio/astroplate" alt="contributors"></a>
+</p>
+
+
+## Key Features 
+
+- Syntax Highlighting
+- Multi-Authors
+- Similar Posts Suggestion 
+- Search Functionality 
+- Dark Mode 
+- Tags & Categories 
+- Netlify setting pre-configured
+- Support contact form 
+- Fully responsive
+- Write and update content in Markdown / MDX
+- Disqus Comment 
+
+### Pages 
+
+- Homepage 
+- About 
+- Contact 
+- Authors 
+- Author Single 
+- Blog
+- Blog Single 
+- Custom 404 
+- Elements 
+- Privacy Policy 
+- Tags 
+- Tag Single 
+- Categories 
+- Category Single 
+- Search 
+
+### Sections 
+
+- Testimonial 
+- Call To Action 
+
+## Integrations
+
+- astro/react 
+- astro/sitemap
+- astro/tailwind 
+
+
+
+## Getting Started
+
+### Dependencies 
 
 - astro 2.3+
 - node v18+
 - npm v9.5+
 - tailwind v3.3+
 
-## Development Command
+### Development Command
 
 ```
 npm run dev
 ```
 
-## Build Command
+### Build Command
 
 ```
 npm run build
 ```
+
+
+<!-- reporting issue -->
+## Reporting Issues
+
+We use GitHub Issues as the official bug tracker for this Template. Please Search [existing issues](https://github.com/zeon-studio/astroplate/issues). It’s possible someone has already reported the same problem.
+If your problem or idea has not been addressed yet, feel free to [open a new issue](https://github.com/zeon-studio/astroplate/issues).
+
+
+<!-- licence -->
+## License
+
+Copyright (c) 2023 - Present, Designed & Developed by [Zeon Studio](https://zeon.studio/)
+
+**Code License:** Released under the [MIT](https://github.comzeon-studio/astroplate/blob/main/LICENSE) license.
+
+**Image license:** The images are only for demonstration purposes. They have their license, we don't have permission to share those images.
+
+## Need Custom Development Services?
+
+If you need a custom theme, theme customization, or complete website development services from scratch you can [Hire Us](https://zeon.studio/). 
+