diff --git a/README.md b/README.md
index c21254ebc3..3b157fb06d 100644
--- a/README.md
+++ b/README.md
@@ -1,14 +1,30 @@
-# Nuxt
+
-This is the repository for Nuxt3.
+Welcome to Nuxt3 repository ✨
+
+We are currently in private beta in order to stabilize the framework before onboarding the whole community.
## Documentation
You can read documentation online [here](https://nuxt3-docs.vercel.app/get-started/installation)
-Contents are at [/docs/content](./docs/content) directory.
+## 🐞 Reporting bugs
-## Development
+In order to report a bug, please use the [New issue](https://github.com/nuxt/framework/issues/new) form and follow the template to provide a bug reproduction.
+
+## 💡 Suggestions
+
+Please create a [discussion](https://github.com/nuxt/framework/discussions/new) for improvements or feature requests.
+
+## ❔ Questions
+
+Please create a [discussion](https://github.com/nuxt/framework/discussions/new) for improvements or feature requests.
+
+## 💻 Development
- Clone repository
- Install dependencies with `yarn install`