diff --git a/readme.md b/readme.md
new file mode 100644
index 0000000..7ee00db
--- /dev/null
+++ b/readme.md
@@ -0,0 +1,21 @@
+## Github Readme stats
+
+Get dynamically generated github stats on your readmes!
+
+## How to use
+
+Copy paste this into your markdown content and thats it. simple!
+
+change the `?username=` value to your GitHubs's username
+
+```md
+![Anurag's github stats](https://github-readme-stats.vercel.app/api?username=anuraghazra)
+```
+
+## Demo
+
+![Anurag's github stats](https://github-readme-stats.vercel.app/api?username=anuraghazra)
+
+Contributions are welcomed! <3
+
+Made with :heart: and javascript.