diff --git a/README.md b/README.md
index eaa55b0..6d0a971 100644
--- a/README.md
+++ b/README.md
@@ -1 +1,47 @@
 # Engine
+
+This repository contains the full engine for NanoForge.
+It can be used by itself.
+
+The engine is made of multiple components:
+
+- [ecs](packages/ecs)
+- [input](packages/input)
+- [core](packages/core)
+- [common](packages/common)
+- [graphics-2d](packages/graphics-2d)
+- [asset-manager](packages/asset-manager)
+- [sound](packages/sound)
+- [music](packages/music)
+
+This is the full nanoforge engine including all the default libraries.
+
+In order to manage this project we use (pnpm)[https://pnpm.io/]
+
+## Installing dependencies
+
+To install dependencies run:
+
+```sh
+pnpm i
+```
+
+## Building
+
+To build the project run:
+
+```sh
+pnpm build
+```
+
+## Tests
+
+To run tests use:
+
+```sh
+pnpm test
+```
+
+## Setting up a test project
+
+In order to setup a test project see (this)[https://github.com/NanoForge-dev/Engine/docs/Introduction.md]
diff --git a/docs/Introduction.md b/docs/Introduction.md
new file mode 100644
index 0000000..aa34ac7
--- /dev/null
+++ b/docs/Introduction.md
@@ -0,0 +1,14 @@
+# Introduction to using the Engine
+
+Whether you work on this engine as a devlopper or you wanna use this engine you gonna want to have a test project.
+This is a walkthrough on how to setup a basic project
+
+## As a devlopper on the engine
+
+As a devlopper you want to be able to use your changes in your project.
+Therefore it is recommended to use the provided template in the [example](https://github.com/NanoForge-dev/Engine/tree/main/example/template)
+
+## As a user
+
+As a user you can either use the template and change the dependencies location.
+Or you can create a project and add the nanoforge dependencies. Note that it is recommended to use bun as a package manager.
diff --git a/packages/asset-manager/README.md b/packages/asset-manager/README.md
index 82cb3ec..48c39b4 100644
--- a/packages/asset-manager/README.md
+++ b/packages/asset-manager/README.md
@@ -1 +1,25 @@
 # Engine Asset Manager
+
+## Installing dependencies
+
+To install dependencies run:
+
+```sh
+pnpm i
+```
+
+## Building
+
+To build the project run:
+
+```sh
+pnpm build
+```
+
+## Tests
+
+To run tests use:
+
+```sh
+pnpm test
+```
diff --git a/packages/common/README.md b/packages/common/README.md
index fa59837..7fe8c72 100644
--- a/packages/common/README.md
+++ b/packages/common/README.md
@@ -1 +1,25 @@
 # Engine Common
+
+## Installing dependencies
+
+To install dependencies run:
+
+```sh
+pnpm i
+```
+
+## Building
+
+To build the project run:
+
+```sh
+pnpm build
+```
+
+## Tests
+
+To run tests use:
+
+```sh
+pnpm test
+```
diff --git a/packages/config/README.md b/packages/config/README.md
index cd5ac6e..41aa4db 100644
--- a/packages/config/README.md
+++ b/packages/config/README.md
@@ -1 +1,25 @@
 # Engine Config
+
+## Installing dependencies
+
+To install dependencies run:
+
+```sh
+pnpm i
+```
+
+## Building
+
+To build the project run:
+
+```sh
+pnpm build
+```
+
+## Tests
+
+To run tests use:
+
+```sh
+pnpm test
+```
diff --git a/packages/core/README.md b/packages/core/README.md
index 8680ad6..bbb9215 100644
--- a/packages/core/README.md
+++ b/packages/core/README.md
@@ -1 +1,25 @@
 # Engine Core
+
+## Installing dependencies
+
+To install dependencies run:
+
+```sh
+pnpm i
+```
+
+## Building
+
+To build the project run:
+
+```sh
+pnpm build
+```
+
+## Tests
+
+To run tests use:
+
+```sh
+pnpm test
+```
diff --git a/packages/ecs/README.md b/packages/ecs/README.md
index 8b72baf..e1d7175 100644
--- a/packages/ecs/README.md
+++ b/packages/ecs/README.md
@@ -1,4 +1,24 @@
-# Engine Core
+# ECS
+
+## What is an ECS
+
+"Entity–component–system (ECS) is a software architectural pattern mostly used in video game development for the representation of game world objects. An ECS comprises entities composed from components of data, with systems which operate on the components."
+[Wikipedia](https://en.wikipedia.org/wiki/Entity_component_system)
+
+## How to build
+
+In order to build this ECS we need to first install a wasm compiler. For this project we gonna use `emsdk`.
+You will also need `make` and `pnpm`
+
+### Installing dependencies
+
+To install dependencies run:
+
+```sh
+pnpm i
+```
+
+#### How to install the emsdk compiler:
 
 To install emsdk the WASM compiler we are using run :
 
@@ -11,3 +31,30 @@ source "$PWD/emsdk_env.sh"
 echo -ne "export EMSDK_QUIET=1\nsource \"$PWD/emsdk_env.sh\"\n" >> ~/.bashrc
 cd ..
 ```
+
+### Building
+
+Now that you have the dependencies you can build by running:
+
+```sh
+pnpm build
+```
+
+This will produce 2 files in the `lib/` directory.
+
+- `libecs.js`, which is the file containg the javascript binding permitting the javascript to interract with the wasm.
+- `libecs.wasm`, the compile code library
+
+If you only wanna build the c++ part just use:
+
+```sh
+make
+```
+
+## Tests
+
+To run tests use:
+
+```sh
+pnpm test
+```
diff --git a/packages/graphics-2d/README.md b/packages/graphics-2d/README.md
index 5d16e80..63af5c0 100644
--- a/packages/graphics-2d/README.md
+++ b/packages/graphics-2d/README.md
@@ -1 +1,25 @@
 # Engine Graphics 2D
+
+## Installing dependencies
+
+To install dependencies run:
+
+```sh
+pnpm i
+```
+
+## Building
+
+To build the project run:
+
+```sh
+pnpm build
+```
+
+## Tests
+
+To run tests use:
+
+```sh
+pnpm test
+```
diff --git a/packages/input/README.md b/packages/input/README.md
index 33e4d47..978bd3e 100644
--- a/packages/input/README.md
+++ b/packages/input/README.md
@@ -1 +1,25 @@
 # Engine Input
+
+## Installing dependencies
+
+To install dependencies run:
+
+```sh
+pnpm i
+```
+
+## Building
+
+To build the project run:
+
+```sh
+pnpm build
+```
+
+## Tests
+
+To run tests use:
+
+```sh
+pnpm test
+```
diff --git a/packages/music/README.md b/packages/music/README.md
index ed41a35..85a8e5b 100644
--- a/packages/music/README.md
+++ b/packages/music/README.md
@@ -1 +1,27 @@
 # Music
+
+This is a basic music management library provided with nanoforge.
+
+## Installing dependencies
+
+To install dependencies run:
+
+```sh
+pnpm i
+```
+
+## Building
+
+To build the project run:
+
+```sh
+pnpm build
+```
+
+## Tests
+
+To run tests use:
+
+```sh
+pnpm test
+```
diff --git a/packages/sound/README.md b/packages/sound/README.md
index 33e4d47..62a97db 100644
--- a/packages/sound/README.md
+++ b/packages/sound/README.md
@@ -1 +1,25 @@
-# Engine Input
+# Sound
+
+## Installing dependencies
+
+To install dependencies run:
+
+```sh
+pnpm i
+```
+
+## Building
+
+To build the project run:
+
+```sh
+pnpm build
+```
+
+## Tests
+
+To run tests use:
+
+```sh
+pnpm test
+```