📝 Docs: Update docs

README.md

@@ -10,10 +10,21 @@
 
 # tevm-monorepo
 
-Tevm tools include an Ethereum devnet that can run in the Browser and Node.js along with a solidity bundler that allows you to import solidity directly into TypeScript files. All built on top of the viem API.
+Tevm enables next generation UX for users while providing delightful DX for developers. It's like sticking an RPC node in your web app and making Solidity contracts a first class citizen.
+
+Some things you can do with Tevm.
+
+- Estimate gas with no loading spinners
+- Remove latency from many JSON-RPC requests
+- Add optimistic updates to your UI
+- Run arbitrary solidity code in the browser for code reuse
+- Cut latency of some calls in half with a typesafe scripting api
+- Use JSON-RPC methods like debug_traceCall even if the underlying RPC does not support it
+- And much more
+
+Here is a code example of what Tevm looks like
 
 ```typescript
-// import solidity directly into typescript
 import { ERC20 } from '@openzeppelin/contracts/token/ERC20/ERC20.sol'
 import { createMemoryClient, http } from 'tevm'
 import { optimism } from 'tevm/common'
@@ -33,6 +44,8 @@ const balance = await client.readContract(
 )
 ```
 
+Tevm is able to fork a network similar to anvil in the browser and execute contract calls. You will also notice Tevm Bundler allows us to import contract abis directly from solidity contracts. These powerful primitives are the key to Tevm.
+
 ## [Join Telegram](https://t.me/+ANThR9bHDLAwMjUx)
 
 ## Visit [Docs (under heavy construction)](https://tevm.sh/) for docs, guides, API, and more! 📄

docs/astro.sidebar.config.mjs

@@ -1,19 +1,33 @@
+import { typeDocSidebarGroup } from 'starlight-typedoc'
+
 export const sidebarConfig = [
     {
         "label": "Getting started guide",
         "link": "/getting-started/getting-started/"
     },
     {
-        "label": "Why",
+        "label": "Why?",
         "items": [
             {
-                "label": "Slow waterfall calls",
-                "link": "/why/avoid-waterfalls/"
+                "label": "Why Tevm",
+                "link": "/why/"
             },
             {
                 "label": "Advanced gas estimation",
                 "link": "/why/advanced-gas-estimation/"
             },
+            {
+                "label": "Slow waterfall calls",
+                "link": "/why/avoid-waterfalls/"
+            },
+            {
+                "label": "Reuse solidity",
+                "link": "/why/reuse-solidity/"
+            },
+            {
+                "label": "Optimistic UI",
+                "link": "/why/optimistic-updates/"
+            },
             {
                 "label": "Writing tests",
                 "link": "/why/writing-tests/"
@@ -22,23 +36,80 @@ export const sidebarConfig = [
                 "label": "Writing UI in solidity",
                 "link": "/why/write-ui-in-solidity/"
             },
+        ]
+    },
+    {
+        "label": "TevmNode",
+        "items": [
             {
-                "label": "Optimistic UI",
-                "link": "/why/reuse-solidity/"
+                "label": "Overview",
+                "link": "/learn/tevm-node/"
             },
             {
-                "label": "Why Tevm",
-                "link": "/why/"
+                "label": "TevmNode api",
+                "link": "/learn/tevm-node/installation/"
             },
             {
-                "label": "Optimistic UI",
-                "link": "/why/optimistic-updates/"
+                "label": "Actions",
+                "link": "/learn/actions/"
+            },
+            {
+                "label": "Tevm clients guide",
+                "link": "/learn/viem/"
+            },
+            {
+                "label": "Cli",
+                "link": "/learn/cli/"
+            },
+            {
+                "label": "JSON-RPC",
+                "link": "/learn/json-rpc/"
+            },
+            {
+                "label": "Contract action creators",
+                "link": "/learn/contracts/"
+            },
+            {
+                "label": "Vm component",
+                "link": "/learn/tevm-node/vm/"
+            },
+            {
+                "label": "TevmNode api",
+                "link": "/learn/tevm-node/txpool/"
+            },
+            {
+                "label": "TevmNode api",
+                "link": "/learn/tevm-node/create-tevm-node/"
+            },
+            {
+                "label": "TevmNode api",
+                "link": "/learn/tevm-node/receipts-manager/"
+            },
+            {
+                "label": "TevmNode api",
+                "link": "/learn/tevm-node/filters/"
+            },
+            {
+                "label": "TevmNode api",
+                "link": "/learn/tevm-node/copying-or-forking/"
+            },
+            {
+                "label": "TevmNode api",
+                "link": "/learn/tevm-node/using-jsonrpc/"
+            },
+            {
+                "label": "Advanced scripting guide",
+                "link": "/learn/scripting/"
             }
         ]
     },
     {
-        "label": "Learn",
+        "label": "TevmNode",
         "items": [
+            {
+                "label": "TevmNode api",
+                "link": "/learn/tevm-node/installation/"
+            },
             {
                 "label": "Bundler Guide",
                 "link": "/learn/solidity-imports/"
@@ -69,13 +140,9 @@ export const sidebarConfig = [
                 "link": "/learn/contracts/"
             },
             {
-                "label": "TevmNode api",
+                "label": "Vm component",
                 "link": "/learn/tevm-node/vm/"
             },
-            {
-                "label": "TevmNode api",
-                "link": "/learn/tevm-node/installation/"
-            },
             {
                 "label": "TevmNode api",
                 "link": "/learn/tevm-node/txpool/"
@@ -109,5 +176,6 @@ export const sidebarConfig = [
                 "link": "/learn/scripting/"
             }
         ]
-    }
+    },
+    typeDocSidebarGroup
 ]

docs/src/content/docs/learn/tevm-node/index.md

@@ -4,7 +4,25 @@ description: Using TevmNode from `tevm/node` package
 ---
 # TevmNode
 
-A lightweight performant JavaScript native Ethereum Virtual Machine (EVM) enabling next-generation local-first UX for end users.
+A lightweight performant JavaScript native Ethereum Virtual Machine (EVM) Node that runs in Node.js and the Browser.
+
+
+```typescript
+import {createTevmNode} from 'tevm'
+
+const node = createTevmNode()
+```
+
+## Why run an ethereum node in the browser
+
+There are many reasons to want to run an Ethereum Node in the browser. Use cases include:
+
+- Advanced gas estimation use cases
+- Better ux via improved latency vs making remote RPC requests
+- Access to low level control
+- Optimistic updates
+- Reusing solidity
+- More!
 
 ## Summary