diff --git a/README.md b/README.md
index 045a439..3834903 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,64 @@
-# nextjs
-A place for me to learn nextjs
+# Next.js
+A place for me to learn Next.js
+
+Official Next.js docs: https://nextjs.org/docs/app/getting-started/installation
+
+Next.js is developed & maintained by Vercel
+
+## Installation (macOS)
+Requirements:
+- Homebrew already installed
+
+Install nodejs
+```zsh
+brew install node@22
+```
+
+Check node version
+```zsh
+node -v
+```
+
+Check NPM version
+```zsh
+npm -v
+```
+
+If you get some errors:
+```zsh
+brew cleanup
+```
+
+Then try again
+
+## Create new project
+```zsh
+npx create-next-app@latest
+```
+
+Afterwards some questions about the project will be asked.
+You can leave the settings as default.
+
+## Run development server
+```zsh
+npm run dev
+```
+
+Afterwards the site can be accessed in the browser at `http://localhost:3000`.
+![New Next.js project](./docs/installation/empty_next_js_app.jpg)
+
+
+## General structure
+The whole app is organzied in multiple folders. THe typescript files for the app are stored in `src/app`.
+
+The code is written in TypeScript.
+
+In `package.json` are the dependencies saved. The Next.js configuration is saved in `next.config.ts`.
+
+Each folder in `app` represents a route of the application, but its only accessable when a `page.js` or `route.js` file is contained.
+
+When a folder is named with `_` as prefix, it will be ignored by the routing and not accessable from within the application.
+
+Folders in parenthesis (Klammern) while not be show in the route. (https://nextjs.org/docs/app/getting-started/project-structure#organize-routes-without-affecting-the-url-path)
+
+Slugs can be defined by creating a folder in brackets [] like [slug].
\ No newline at end of file
diff --git a/docs/installation/empty_next_js_app.jpg b/docs/installation/empty_next_js_app.jpg
new file mode 100644
index 0000000..622a59c
Binary files /dev/null and b/docs/installation/empty_next_js_app.jpg differ