diff --git a/README.md b/README.md
index c78970b..41a80db 100644
--- a/README.md
+++ b/README.md
@@ -1 +1,73 @@
-# starkweb
\ No newline at end of file
+
+
+<p align="center">
+  <img alt="Starkweb" src="https://raw.githubusercontent.com/nethermindeth/starkweb/main/app/starkweb/docs/public/starkweb_horizontal_dark.svg" height="64">
+</p>
+
+[![Chat on Telegram](https://img.shields.io/badge/telegram-join%20chat-blue.svg)](https://t.me/strkweb)
+[![Follow us on Twitter](https://img.shields.io/twitter/follow/NethermindStark?style=social&label=Follow)](https://twitter.com/NethermindStark)
+
+
+Building on Starknet is complex—wallet connections, multi-chain support, transactions, event monitoring, and state updates all require seamless handling, and constant ecosystem changes add to the challenge.
+
+Starkweb simplifies development with a focus on performance, stability, and developer experience, letting teams build without friction.
+
+
+
+## Documentation
+
+Starkweb documentation is available at [starkweb.xyz](https://starkweb.xyz).
+
+## Installing
+
+### Package Managers
+
+- **npm**
+  ```bash
+  npm install starkweb
+  ```
+
+- **pnpm**
+  ```bash
+  pnpm create starkweb
+  ```
+
+- **yarn**
+  ```bash
+  yarn create starkweb
+  ```
+
+Once installed, you can initialize Starkweb as follows:
+
+```typescript
+// 1. Import modules.
+import { createPublicClient, http } from "starkweb";
+import { mainnet } from "starkweb/chains";
+ 
+// 2. Set up your client with desired chain & transport.
+const client = createPublicClient({
+  chain: mainnet,
+  transport: http(),
+});
+ 
+// 3. Consume an action!
+ 
+const blockNumber = await client.getBlockNumber();
+```
+
+For further instructions, [Visit the docs](https://www.starkweb.xyz/).
+
+
+## Community
+
+Join our community channels:
+- Follow [@NethermindStark](https://twitter.com/NethermindStark) on Twitter.
+- Join our [Telegram channel](https://t.me/strkweb).
+
+## Contributing
+
+Before starting work on a feature or fix, please read our [contributing guidelines](./CONTRIBUTING.md) to ensure efficient collaboration.
+
+## License
+
+Starkweb is open-source software licensed under the Apache License 2.0 License.
\ No newline at end of file
diff --git a/app/starkweb/README.md b/app/starkweb/README.md
index 3bb11a4..f1e0620 100644
--- a/app/starkweb/README.md
+++ b/app/starkweb/README.md
@@ -1 +1,47 @@
-This is a [Vocs](https://vocs.dev) project bootstrapped with the Vocs CLI.
+This is a [Vocs] (https://vocs.dev) documentation project bootstrapped with the Vocs CLI.
+
+## Installation
+
+Clone this repository and install dependencies:
+
+```bash
+git clone https://github.com/NethermindEth/starkweb.git
+cd app/starkweb/docs
+npm i vocs
+```
+
+Then add the following scripts to your `package.json`:
+
+```json
+{
+  "scripts": {
+    "docs:dev": "vocs dev",
+    "docs:build": "vocs build",
+    "docs:preview": "vocs preview"
+  }
+}
+```
+
+To start the development server, run:
+
+```bash
+npm run docs:dev
+```
+
+This will launch the documentation site at [http://localhost:5173](http://localhost:5173).
+
+### Building for Production
+
+To build the documentation for production:
+
+```bash
+npm run docs:build
+```
+
+To preview the production build:
+
+```bash
+npm run docs:preview
+```
+
+Visit the [Vocs documentation](https://vocs.dev) for more complex functionality around the tool.
\ No newline at end of file
diff --git a/app/starkweb/package.json b/app/starkweb/package.json
index 8632361..1ad21af 100644
--- a/app/starkweb/package.json
+++ b/app/starkweb/package.json
@@ -12,8 +12,8 @@
     "@types/react": "latest",
     "react": "latest",
     "react-dom": "latest",
+    "starkweb": "latest",
     "typescript": "latest",
-    "vocs": "latest",
-    "starkweb": "latest"
+    "vocs": "^1.0.0-alpha.62"
   }
 }
diff --git a/app/starkweb/vocs.config.ts b/app/starkweb/vocs.config.ts
index 8b49ee7..bdbf7b5 100644
--- a/app/starkweb/vocs.config.ts
+++ b/app/starkweb/vocs.config.ts
@@ -3,6 +3,10 @@ import { defineConfig } from "vocs";
 export default defineConfig({
   title: "Starkweb",
   description: "all-in-one Starknet Toolkit",
+    editLink: {
+          pattern: 'https://github.com/NethermindEth/starkweb/tree/main/app/starkweb/docs/pages/:path',
+          text: 'Edit this Page',
+      },
   socials: [
     {
       icon: "github",