diff --git a/README.md b/README.md
new file mode 100644
index 00000000..2b105480
--- /dev/null
+++ b/README.md
@@ -0,0 +1,23 @@
+# Wellium
+
+[![GitHub](https://img.shields.io/badge/github-by--The--Lindemans/wellium-8da0cb?style=for-the-badge&labelColor=007fff&logo=github)](https://github.com/by-The-Lindemans/wellium)
+[![WASM Build](https://img.shields.io/github/actions/workflow/status/by-The-Lindemans/wellium/deploy.yml?branch=main&style=for-the-badge)](https://github.com/by-The-Lindemans/wellium/actions/workflows/deploy.yml)
+[![License: MIT](https://img.shields.io/badge/License-MPLv2-blue.svg?style=for-the-badge)](https://opensource.org/licenses/MPL-2-0)
+[![dependency status](https://deps.rs/repo/github/by-The-Lindemans/wellium/status.svg?style=for-the-badge)](https://deps.rs/repo/github/by-The-Lindemans/wellium)
+[![GitHub release](https://img.shields.io/github/release/by-The-Lindemans/wellium.svg?style=for-the-badge)](https://github.com/by-The-Lindemans/wellium/releases)
+[![GitHub contributors](https://img.shields.io/github/contributors/by-The-Lindemans/wellium.svg?style=for-the-badge)](https://github.com/by-The-Lindemans/wellium/graphs/contributors)
+[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=for-the-badge)](http://makeapullrequest.com)
+
+
+## Contributing
+
+We welcome contributions from the community! Please read our [CONTRIBUTING.md](CONTRIBUTING.md) for instructions on how to contribute to the project.
+
+- Fork the repository
+- Create a new branch
+- Make your changes and submit a pull request
+
+
+## Support
+
+If you have any questions or need help, feel free to [open an issue](https://github.com/by-The-Lindemans/wellium/issues).