diff --git a/README.md b/README.md
index 2812dc2..cb4653d 100644
--- a/README.md
+++ b/README.md
@@ -1,60 +1,113 @@
-
+
+
+
-## Setup
+[](https://github.com/linera-io/linera-web/stargazers)
+[](https://github.com/linera-io/linera-web/network/members)
+[](https://github.com/linera-io/linera-web/commits/main)
+[](LICENSE)[](https://linera.io)
+[](https://t.me/linera_io)
+[](https://discord.gg/linera)
+[](https://x.com/linera_io)
-This repository contains a Nix flake that precisely specifies its
-build environment. The easiest way to set up the build environment is
-to install Nix with flake support (e.g. using the [Determinate Nix
-installer](https://github.com/DeterminateSystems/nix-installer)) and
-then run `nix develop` to enter the build environment.
-Currently we only support building on Linux (`x86_64-unknown-linux-gnu`).
+
-## Building
+---
-The project builds with `pnpm`. First install the JavaScript dependencies:
+## **Setup**
-```shellsession
-pnpm install
+This repository includes a **Nix flake** that precisely specifies its build environment.
+To set up, install **Nix** with flake support (e.g., via the [Determinate Nix Installer](https://github.com/DeterminateSystems/nix-installer))
+and then run:
+
+**Enter the build environment**
+
+```bash
+nix develop
```
-Then build the extension:
+Currently, **only Linux (`x86_64-unknown-linux-gnu`)** is supported.
+
+---
+
+## **Building the Project**
-```shellsession
-cd extension
-pnpm build:extension
+Linera Web Client builds with **pnpm**.
+
+**1. Install JavaScript dependencies:**
+
+```bash
+pnpm install
```
-This will result in an unpacked Manifest v3 extension in
-`extension/dist/extension`.
+**2. Build the extension:**
+
+```bash
+cd extension && pnpm build:extension
+ ```
-# Installation
+This will generate an **unpacked Manifest v3 extension** in `extension/dist/extension`.
-After successfully running `pnpm build`, the extension can be loaded
-into Chrome or Chromium:
+---
-- Open the settings menu.
-- Select ‘Extensions’ → ‘Manage Extensions’.
-- Enable ‘Developer mode’. This will show an option ‘Load unpacked’.
-- Navigate to the `extension/dist` directory and select it.
-- You've installed the extension!
+## **Installation**
-By default extension icons are hidden behind a top-level ‘Extensions’
-menu in the browser toolbar; to make access easier, you can pin this
-extension to have it appear at the top level next to the ‘Extensions’
-icon.
+After successfully building the extension, you can load it into **Chrome/Chromium**:
-# Development
+1. Open the **settings menu**.
+2. Navigate to **Extensions** → **Manage Extensions**.
+3. Enable **Developer mode** (this will show an option **Load unpacked**).
+4. Select the `extension/dist` directory.
+5. **Done! The extension is installed!**
+
+To make access easier, **pin the extension** to appear in the top-level toolbar.
+
+---
+
+## **Development Mode**
+
+For development, use the **watch mode** to automatically rebuild on changes:
+
+```bash
+pnpm build --watch
+```
+
+Changes to the **client worker** won’t be reflected until you manually run:
+
+```bash
+wasm-pack build
+```
-## Environment
+---
+
+## **Join the Community**
+
+
+
+ 
+
+
+ 
+
+
+ 
+
+
+
+ 
+
+
+ 
+
+
+ 
+
+
-For development, you can also use `pnpm build --watch` to
-automatically rebuild the extension on change. Changes to the client
-worker will not propagate to the extension, but once you run
-`wasm-pack build` they will be picked up.