git » sdk » commit 65e65dc

diff --git a/.gitignore b/.gitignore
index 1d53d37..6174b23 100644
--- a/.gitignore
+++ b/.gitignore
@@ -15,3 +15,4 @@ site
 haxedoc.xml
 cpp
 venv
+docs/js/borogove*.md
diff --git a/docs/index.md b/docs/index.md
new file mode 120000
index 0000000..32d46ee
--- /dev/null
+++ b/docs/index.md
@@ -0,0 +1 @@
+../README.md
\ No newline at end of file
diff --git a/docs/js/index.md b/docs/js/index.md
new file mode 100644
index 0000000..59c77e4
--- /dev/null
+++ b/docs/js/index.md
@@ -0,0 +1,89 @@
+# Getting Started
+
+This guide quickly brings you up to speed on Borogove's JavaScript API. The API is flexible and allows you to build any type of chat or messaging.
+
+```console
+npm i https://gitpkg-singpolyma.vercel.app/snikket-im/snikket-sdk/npm?compiled
+```
+
+## Chat Client
+
+Let's get started by  initializing the client and setting the current user and persistence layer:
+
+```typescript
+import * as borogove from "borogove";
+
+// Cache avatars and other media in browser cache
+const mediaStore = borogove.persistence.MediaStoreCache("myapp");
+
+// Store chats and history in IndexedDB
+const persist = await borogove.persistence.IDB("snikket", mediaStore);
+
+// Create client
+const client = new borogove.Client("alice@example.com", persist);
+```
+
+This example is for in the browser, but for other context only the persistence choices will need to change.
+
+Now we need to connect to the server, which must be a [Snikket](https://snikket.org)-compatible instance living at `example.com`, and authenticate the user:
+
+```typescript
+client.addPasswordNeededListener() => {
+	client.usePassword("mycoolpassword");
+});
+
+client.start();
+```
+
+In real life you probably want to prompt the user when receiving the event. You should not store the password anywhere, as Borogove will handle keeping the user's session token persisted until an explicit logout.
+
+## Chats
+
+Let’s continue by starting your fist chat. A chat contains messages, a list of people that are participating, and optionally a list of members. The example below shows how to start a chat with a new contact:
+
+```typescript
+const chat = await new Promise(resolve => {
+	const search = "hatter@example.com";
+	client.findAvailableChats(search, (q, availableChats) => {
+		// Check if the results are for our search
+		// Allows running searches in parallel as a user types
+		if (search !== q) return;
+
+		resolve(client.startChat(availableChats[0]));
+
+		// Stop searching
+		return true;
+	});
+});
+```
+
+[`findAvailableChats`](./borogove.client.findavailablechats.md) will call the callback with all results found so far, and keep searching until either it has exhausted all options or the callback returns `true`. Here we just create a promise to resolve to the first chat that is found.
+
+You can always search by the full ID or URI of any chat on the network. Locally known chats will also be returned, as well as any chats from other services configured on the account.
+
+If you have already used a chat before, you can always get it from [`getChat`](./borogove.client.getchat.md) or list all known chats with [`getChats`](./borogove.client.getchats.md).
+
+## Messages
+
+Now that we have the chat set up, let's send our first message.
+
+```typescript
+chat.sendMessage(new borogove.ChatMessageBuilder({
+	text: "I would like some tea."
+}));
+```
+
+## Events
+
+This is how you can listen to events:
+
+```typescript
+const onlineEventToken = client.addStatusOnlineListener(() => {
+	console.log(`${client.accountId()} is online and in sync`)
+});
+
+const messageEventToken = client.addMessageListener((message, eventType) => {
+	console.log(`Message ${mesage.text} received or updated`, eventType);
+});
+
+```
diff --git a/mkdocs.yml b/mkdocs.yml
index 4f3fbac..d82bc80 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -2,6 +2,7 @@ site_name: "Borogove SDK"
 
 theme:
   name: readthedocs
+  prev_next_buttons_location: false
 
 plugins:
   - search
@@ -22,7 +23,9 @@ markdown_extensions:
   - markdown.extensions.md_in_html
 
 nav:
-  - Home: index.md
-  - API:
-    - C: c/borogove_8h.md
-    - JavaScript: js/borogove.md
+  - README: index.md
+  - C:
+    - API Reference: c/borogove_8h.md
+  - JavaScript:
+    - js/index.md
+    - API Reference: js/borogove.md