diff --git a/README.md b/README.md
index 190a44b2..4e345b96 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,46 @@
-# web-ui-sdks
-Web SDKs for building customizable login UIs for Asgardeo & WSO2 Identity Server
+
+
+
+ Web SDKs
+
+
+
+ Web SDKs for building customizable UIs for Asgardeo & WSO2 Identity Server
+
+
+
+

+
+

+
+
+
+
+
+
+
+This repository contains the source code of the different Web SDKs that can be used to build customizable UIs for Asgardeo and WSO2 Identity Server. If you have any questions, please reach out to us through one of the following channels:
+
+[](https://stackoverflow.com/questions/tagged/wso2is)
+[](https://discord.gg/wso2)
+[](https://twitter.com/intent/follow?screen_name=wso2)
+
+## Packages
+
+| Package | Description |
+| --- | --- |
+| [](./packages/core/) | Framework-agnostic JavaScript Core SDK |
+| [](./packages/react/) | React SDK for building customizable UIs for React applications |
+
+## Contribute
+Please read [Contributing to the Code Base](http://wso2.github.io/) for details on our code of conduct, and the process for submitting pull requests to us.
+
+### Reporting issues
+We encourage you to report issues, improvements, and feature requests creating [Github Issues](https://github.com/asgardeo/asgardeo-auth-react-sdk/issues).
+
+Important: And please be advised that security issues must be reported to security@wso2com, not as GitHub issues, in order to reach the proper audience. We strongly advise following the WSO2 Security Vulnerability Reporting Guidelines when reporting the security issues.
+
+## License
+This project is licensed under the Apache License 2.0. See the [LICENSE](LICENSE) file for details.