diff --git a/README.md b/README.md
index 1926036..1a89680 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,46 @@
-# bladewind-ui-components
-UI Components using TailwindCSS , Laravel Blade Templates and vanilla Javascript
+
+
+## About BladewindUI
+
+BladewindUI is a collection of UI components written purely using TailwindCSS, Laravel blade templates and Vanilla Javascript. These components are super simple to use and come with different levels of customization.
+
+### Components Include
+
+- **[Alert](https://bladewindui.com/component/alert)**
+- **[Avatar](https://bladewindui.com/component/avatar)**
+- **[Button](https://bladewindui.com/component/button)**
+- **[Card](https://bladewindui.com/component/card)**
+- **[Centered Element](https://bladewindui.com/component/centered-element)**
+- **[Checkbox](https://bladewindui.com/component/checkbox)**
+- **[Datepicker](https://bladewindui.com/component/datepicker)**
+- **[Dropdown](https://bladewindui.com/component/dropdown)**
+- **[Empty State](https://bladewindui.com/component/empty-state)**
+- **[Filepicker](https://bladewindui.com/component/filepicker)**
+- **[Horizontal Line Graph](https://bladewindui.com/component/horizontal-line-graph)**
+- **[List View](https://bladewindui.com/component/list-view)**
+- **[Modal](https://bladewindui.com/component/modal)**
+- **[Notification](https://bladewindui.com/component/notification)**
+- **[Process Indicator](https://bladewindui.com/component/process-indicator)**
+- **[Progress Bar](https://bladewindui.com/component/progress-bar)**
+- **[Radio Button](https://bladewindui.com/component/radio-button)**
+- **[Rating](https://bladewindui.com/component/rating)**
+- **[Statistic](https://bladewindui.com/component/statistic)**
+- **[Spinner](https://bladewindui.com/component/spinner)**
+- **[Tab](https://bladewindui.com/component/tab)**
+- **[Table](https://bladewindui.com/component/table)**
+- **[Tag](https://bladewindui.com/component/tag)**
+- **[Textbox](https://bladewindui.com/component/textbox)**
+- **[Textarea](https://bladewindui.com/component/textarea)**
+- **[Toggle](https://bladewindui.com/component/toggle)**
+
+
+
+## Security Vulnerabilities
+
+If you discover a security vulnerability, please e-mail Michael K. Ocansey at [kabutey@gmail.com](mailto:kabutey@gmail.com).
+
+
+
+## License
+
+BladewindUI components is open-sourced software licensed under the [MIT license](https://opensource.org/licenses/MIT).