general improvements and restructure of the docs

Author: oscartbeaumont

README.md

@@ -1,3 +1,6 @@
+<p align="center">
+ <img width="150" height="150" src="/docs/public/logo.png" alt="Logo">
+</p>
 <h1 align="center">rspc</h1>
 <p align="center">🚧 Work in progress 🚧</p>
 <div align="center">
@@ -33,7 +36,7 @@
 
 ## Example
 
-You define a `rspc` router and attach resolvers to it like below. This will be very familiar if you have used [trpc](https://trpc.io/) or [GraphQL](https://graphql.org) before.
+You define a `rspc` router and attach procedures to it like below. This will be very familiar if you have used [trpc](https://trpc.io/) or [GraphQL](https://graphql.org) before.
 
 ```rust
 let router = <rspc::Router>::new()

docs/markdown/breaking-changes.md

@@ -5,7 +5,7 @@ index: 3
 
 # 0.0.5 to 0.0.6 - rspc
 
-This release comes with a huge amount of breaking changes. These changes are going to allow for many benefits in the future such as a rich plugin ecosystem. If your having trouble upgrading open a GitHub Issue or jump in the Discord server.
+This release comes with a huge amount of breaking changes. These changes are going to allow for many benefits in the future such as a rich plugin ecosystem. If your having trouble upgrading open a GitHub Issue or jump in the Discord server. New [rspc vscode extension](https://marketplace.visualstudio.com/items?itemName=oscartbeaumont.rspc-vscode) too!
 
 ### Httpz integration
 
@@ -30,10 +30,6 @@ const client = createClient<Operations>({
 });
 ```
 
-#### Axum extractors
-
-TODO - Document changes here - Currently `cookies` can be access from `httpz` but not access through `TCtx` because it doesn't satisfy `'static`.
-
 ### New Typescript bindings format
 
 The internal format of the generated Typescript bindings has changed. The import has also changed so ensure you update your code as follows.

docs/markdown/client/index.md

@@ -1,7 +1,7 @@
 ---
 title: Create Vanilla Client
 header: Vanilla Client
-index: 20
+index: 30
 ---
 
 The vanilla client allows you to consume your API on the frontend. This client is the minimal core and it is recommended that you use the [React](/client/react) or [Solid](/client/solid) integration for building application.
@@ -12,7 +12,7 @@ To get started first install the minimal runtime package.
 npm i @rspc/client
 ```
 
-Next you need to export the Typescript bindings from your `rspc::Router` by using either [export_ts_bindings](/server/router#export_ts_bindings) or [export_ts](/server/router#exporting-the-typescript-bindings).
+Next you need to export the Typescript bindings from your `rspc::Router` by using either [export_ts_bindings](/server/router#exporting-the-typescript-bindings) or [export_ts](/server/router#exporting-the-typescript-bindings).
 
 ```rust
 let router = <rspc::Router>::new()
@@ -39,8 +39,23 @@ const userOne = await client.query(["getUser", 1]);
 const userTwo = await client.mutation(["addUser", { name: "Monty Beaumont" }]);
 ```
 
-[View full example](https://github.com/oscartbeaumont/rspc/tree/main/packages/example/react.tsx)
+# Transports
 
-## Websockets
+rspc has multiple different transports which can be used.
 
-TODO: Document using websocket transport
+```ts
+import { createClient, FetchTransport, WebsocketTransport, NoOpTransport } from "@rspc/client";
+import type { Procedures } from "./bindings.ts"; // The bindings exported from your Rust code!
+
+const fetchClient = createClient<Procedures>({
+  transport: new FetchTransport("http://localhost:4000/rspc"),
+});
+
+const wsClient = createClient<Procedures>({
+  transport: new WebsocketTransport("ws://localhost:8080/rspc/ws"),
+});
+
+
+const noOpClient = createClient<Procedures>({
+  transport: new NoOpTransport(),
+});

docs/markdown/client/react.md

@@ -1,5 +1,6 @@
 ---
 title: React
+index: 31
 ---
 
 rspc can be used on the frontend with [React](https://reactjs.org) via the powerful [React Query](https://tanstack.com/query/v4) library which provides caching, refetching and a lot more.

docs/markdown/client/solidjs.md

@@ -1,8 +1,9 @@
 ---
 title: SolidJS
+index: 32
 ---
 
-rspc can be used on the frontend with [SolidJS](https://www.solidjs.com/) via [solid-query](https://github.com/ardeora/solid-query) which provides caching, refetching and a lot more. 
+rspc can be used on the frontend with [SolidJS](https://www.solidjs.com/) via [Tanstack Solid Query](https://tanstack.com/query/v4/docs/adapters/solid-query) which provides caching, refetching and a lot more. 
 
 To get started first install the required packages.
 

docs/markdown/server/deployment.md docs/markdown/ecosystem/deployment.mddocs/markdown/server/deployment.md renamed to docs/markdown/ecosystem/deployment.md

@@ -1,11 +1,13 @@
 ---
 title: Deployment
+index: 53
 ---
 
-Coming soon...
+## Coming soon...
 
 We will document how to deploy an rspc API to:
 
 - [Vercel Functions](https://vercel.com/docs/concepts/functions) - Tracked in issue [#9](https://github.com/oscartbeaumont/rspc/issues/9)
+- [Netlify Functions](https://www.netlify.com/products/functions/)
 - [Fly.io](https://fly.io)
 - [Docker Container](https://www.docker.com/)

docs/markdown/ecosystem/prisma-client-rust.md

@@ -1,7 +1,8 @@
 ---
 title: Prisma Client Rust
+index: 51
 ---
 
-More extensive docs coming soon...
+## More extensive docs coming soon...
 
 For now check out the Prisma Client Rust documentation on working with [rspc](https://prisma.brendonovich.dev/extra/rspc).

docs/markdown/ecosystem/zer.md

@@ -0,0 +1,6 @@
+---
+title: Zer
+index: 52
+---
+
+## Coming soon...

docs/markdown/integrations/axum.md

@@ -1,12 +1,13 @@
 ---
 title: Axum
+index: 40
 ---
 
-**rspc** has a built-in integration with [Axum](https://github.com/tokio-rs/axum) so that you can expose your API over HTTP.
+rspc has a built-in integration with [Axum](https://github.com/tokio-rs/axum) so that you can expose your API over HTTP.
 
 ### Enable feature
 
-For the integration to work you must enable the `axum` feature of **rspc**. Ensure the rspc line in your `Cargo.toml` file looks like the following:
+For the integration to work you must enable the `axum` feature of rspc. Ensure the rspc line in your `Cargo.toml` file looks like the following:
 
 ```toml
 [dependencies]
@@ -29,8 +30,6 @@ let app = axum::Router::new()
     .layer(cors);
 ```
 
-[View full example](https://github.com/oscartbeaumont/rspc/blob/main/examples/axum.rs)
-
 ### Extracting Context from Request
 
 **Warning: The Axum extractor API is probally going to be removed in a future release. If you are using this API, I would appreciate a message in the Discord about your usecase so I can ensure the replacement API can do everything you need.**

docs/markdown/integrations/tauri.md

@@ -1,13 +1,13 @@
 ---
 title: Tauri
-index: 30
+index: 41
 ---
 
-**rspc** has a built-in integration with [Tauri](https://tauri.app/) so that you can expose your API to your frontend code using Tauri's IPC.
+rspc has a built-in integration with [Tauri](https://tauri.app/) so that you can expose your API to your frontend code using Tauri's IPC.
 
 ### Enable feature
 
-For the integration to work you must enable the `tauri` feature of **rspc**. Ensure the rspc line in your `Cargo.toml` file looks like the following:
+For the integration to work you must enable the `tauri` feature of rspc. Ensure the rspc line in your `Cargo.toml` file looks like the following:
 
 ```toml
 [dependencies]