Docs introduction

2025-03-30 15:08:30 +00:00 · 2023-01-06 04:49:40 -06:00 · 2023-01-06 04:49:40 -06:00 · 8ca9bd65bd
commit 8ca9bd65bd
parent 65b963e09d
38 changed files with 618 additions and 47 deletions
--- a/packages/common/src/schema/Rpc/index.ts
+++ b/packages/common/src/schema/Rpc/index.ts
@ -6,7 +6,7 @@ export const RPC_COLLECTION = 'rpc'
 export enum RpcCommands {
  CreateInstance = 'create-instance',
  BackupInstance = 'backup-instance',
-  RestoreInstance = 'restore-instance',
+  // RestoreInstance = 'restore-instance',
  SaveSecrets = 'save-secrets',
  // gen:enum
 }
@ -14,7 +14,7 @@ export enum RpcCommands {
 export const RPC_COMMANDS = [
  RpcCommands.CreateInstance,
  RpcCommands.BackupInstance,
-  RpcCommands.RestoreInstance,
+  // RpcCommands.RestoreInstance,
  RpcCommands.SaveSecrets,
 ]

--- a/packages/daemon/src/constants.ts
+++ b/packages/daemon/src/constants.ts
@ -36,6 +36,7 @@ export const DAEMON_PB_DATA_DIR = (() => {

 export const NODE_ENV = env('NODE_ENV', '')
 export const DEBUG = envb('DEBUG', NODE_ENV === 'development')
+export const TRACE = envb('TRACE', false)

 export const DAEMON_PB_BACKUP_SLEEP = envi(`DAEMON_PB_BACKUP_SLEEP`, 100)
 export const DAEMON_PB_BACKUP_PAGE_COUNT = envi(
--- a/packages/daemon/src/migrate/migrate.ts
+++ b/packages/daemon/src/migrate/migrate.ts
@ -1,10 +1,10 @@
-import { PH_BIN_CACHE, PUBLIC_PB_SUBDOMAIN } from '$constants'
+import { DEBUG, PH_BIN_CACHE, PUBLIC_APP_DB } from '$constants'
 import { pocketbase } from '$services'
 import { InstanceStatus, logger, safeCatch } from '@pockethost/common'
 import { schema } from './schema'
 import { withInstance } from './withInstance'
 ;(async () => {
-  const { info } = logger().create('migrate')
+  const { info } = logger({ debug: DEBUG }).create('migrate')

  const pbService = await pocketbase({
    cachePath: PH_BIN_CACHE,
@ -23,7 +23,7 @@ import { withInstance } from './withInstance'
    info(`Upgrading`)
    const upgradeProcess = await pbService.spawn({
      command: 'upgrade',
-      slug: PUBLIC_PB_SUBDOMAIN,
+      slug: PUBLIC_APP_DB,
    })
    await upgradeProcess.exited

@ -32,8 +32,9 @@ import { withInstance } from './withInstance'

      await client.updateInstances((instance) => {
        const version = (() => {
-          if (instance.platform === 'ermine') return '^0.7.0'
-          if (instance.platform === 'lollipop') return '^0.10.0'
+          if (instance.platform === 'ermine') return '~0.7.0'
+          if (instance.platform === 'lollipop') return '~0.10.0'
+          return pbService.getLatestVersion()
        })()
        console.log(`Updating instance ${instance.id} to ${version}`)
        return {
--- a/packages/daemon/src/server.ts
+++ b/packages/daemon/src/server.ts
@ -1,4 +1,4 @@
-import { DEBUG, PH_BIN_CACHE, PUBLIC_APP_DB } from '$constants'
+import { DEBUG, PH_BIN_CACHE, PUBLIC_APP_DB, TRACE } from '$constants'
 import {
  backupService,
  clientService,
@ -14,7 +14,7 @@ import { logger } from '@pockethost/common'
 import { centralDbService } from './services/CentralDbService'
 import { instanceLoggerService } from './services/InstanceLoggerService'

-logger({ debug: DEBUG })
+logger({ debug: DEBUG, trace: TRACE })

 // npm install eventsource --save
 global.EventSource = require('eventsource')
--- a/packages/daemon/src/services/CentralDbService.ts
+++ b/packages/daemon/src/services/CentralDbService.ts
@ -7,7 +7,7 @@ export const centralDbService = mkSingleton(async () => {

  ;(await proxyService()).use(
    PUBLIC_APP_DB,
-    ['/api(/*)', '_(/*)'],
+    ['/api(/*)', '/_(/*)'],
    (req, res, meta) => {
      const { subdomain, coreInternalUrl, proxy } = meta

@ -18,7 +18,8 @@ export const centralDbService = mkSingleton(async () => {
        `Forwarding proxy request for ${req.url} to central instance ${target}`
      )
      proxy.web(req, res, { target })
-    }
+    },
+    `CentralDbService`
  )

  return {
--- a/packages/daemon/src/services/InstanceService/InstanceService.ts
+++ b/packages/daemon/src/services/InstanceService/InstanceService.ts
@ -330,7 +330,8 @@ export const instanceService = mkSingleton(
        const endRequest = instance.startRequest()
        res.on('close', endRequest)
        proxy.web(req, res, { target: instance.internalUrl })
-      }
+      },
+      `InstanceService`
    )

    const maintenance = async (instanceId: InstanceId) => {}
--- a/packages/daemon/src/services/PocketBaseService.ts
+++ b/packages/daemon/src/services/PocketBaseService.ts
@ -107,7 +107,7 @@ export const createPocketbaseService = async (
        `No version found, probably mismatched architecture and OS (${osName}/${cpuArchitecture})`
      )
    }
-    maxVersion = `^${rsort(keys(versions))[0]}`
+    maxVersion = `~${rsort(keys(versions))[0]}`
    dbg({ maxVersion })
    return true
  }
--- a/packages/daemon/src/services/ProxyService.ts
+++ b/packages/daemon/src/services/ProxyService.ts
@ -7,7 +7,7 @@ import {
  ServerResponse,
 } from 'http'
 import { default as httpProxy, default as Server } from 'http-proxy'
-import { AsyncReturnType } from 'type-fest'
+import { Asyncify, AsyncReturnType } from 'type-fest'
 import UrlPattern from 'url-pattern'

 export type ProxyServiceApi = AsyncReturnType<typeof proxyService>
@ -45,7 +45,10 @@ export const proxyService = mkSingleton(async (config: ProxyServiceConfig) => {
    }

    try {
-      middleware.forEach((handler) => handler(req, res))
+      for (let i = 0; i < middleware.length; i++) {
+        const m = middleware[i]!
+        await m(req, res)
+      }
    } catch (e) {
      die(`${e}`)
      return
@ -66,13 +69,18 @@ export const proxyService = mkSingleton(async (config: ProxyServiceConfig) => {
    })
  }

-  const middleware: RequestListener[] = []
+  type MiddlewareListener = RequestListener | Asyncify<RequestListener>
+  const middleware: MiddlewareListener[] = []

  const use = (
    subdomainFilter: string | ((subdomain: string) => boolean),
    urlFilters: string | string[],
-    handler: ProxyMiddleware
+    handler: ProxyMiddleware,
+    handlerName: string
  ) => {
+    const { dbg, trace } = logger().create(`ProxyService:${handlerName}`)
+    dbg({ subdomainFilter, urlFilters })
+
    const _urlFilters = Array.isArray(urlFilters)
      ? urlFilters.map((f) => new UrlPattern(f))
      : [new UrlPattern(urlFilters)]
@ -110,7 +118,7 @@ export const proxyService = mkSingleton(async (config: ProxyServiceConfig) => {
          return isMatch
        })
      ) {
-        trace(`${url} does not match pattern ${urlFilters}`)
+        dbg(`${url} does not match pattern ${urlFilters}`)
        return
      }
      dbg(`${url} matches ${urlFilters}, sending to handler`)
--- a/packages/daemon/src/services/RealtimeLog.ts
+++ b/packages/daemon/src/services/RealtimeLog.ts
@ -138,7 +138,7 @@ export const realtimeLog = mkSingleton(async (config: RealtimeLogConfig) => {
          `Dispatching SSE log event from ${instance.subdomain} (${instance.id})`,
          evt
        )
-        limiter.schedule(() => write(evt))
+        limiter.schedule(() => write(evt)).catch(error)
      })
      req.on('close', () => {
        limiter.stop()
@ -157,24 +157,32 @@ export const realtimeLog = mkSingleton(async (config: RealtimeLogConfig) => {
        recs
          .sort((a, b) => (a.created < b.created ? -1 : 1))
          .forEach((rec) => {
-            limiter.schedule(async () => {
-              if (_seenIds?.[rec.id]) return // Skip if update already emitted
-              const evt = mkEvent(`log`, rec)
-              // dbg(
-              //   `Dispatching SSE initial log event from ${instance.subdomain} (${instance.id})`,
-              //   evt
-              // )
-              return write(evt)
-            })
+            limiter
+              .schedule(async () => {
+                if (_seenIds?.[rec.id]) {
+                  trace(`Record ${rec.id} already sent `)
+                  return
+                } // Skip if update already emitted
+                const evt = mkEvent(`log`, rec)
+                trace(
+                  `Dispatching SSE initial log event from ${instance.subdomain} (${instance.id})`,
+                  evt
+                )
+                return write(evt)
+              })
+              .catch(error)
          })
-        limiter.schedule(async () => {
-          // Set seenIds to `undefined` so the subscribe listener stops tracking them.
-          _seenIds = undefined
-        })
+        limiter
+          .schedule(async () => {
+            // Set seenIds to `undefined` so the subscribe listener stops tracking them.
+            _seenIds = undefined
+          })
+          .catch(error)
      }

      return true
-    }
+    },
+    `RealtimeLogService`
  )

  return {
--- a/packages/pockethost.io/marked.config.js
+++ b/packages/pockethost.io/marked.config.js
@ -0,0 +1,8 @@
+import hljs from 'highlight.js'
+
+const highlight = (code, lang) => {
+  lang = lang && hljs.getLanguage(lang) ? lang : 'plaintext'
+  return hljs.highlight(code, { language: lang }).value
+}
+
+export default { highlight }
--- a/packages/pockethost.io/package.json
+++ b/packages/pockethost.io/package.json
@ -27,6 +27,7 @@
  },
  "type": "module",
  "dependencies": {
+    "@dansvel/vite-plugin-markdown": "^2.0.5",
    "@microsoft/fetch-event-source": "https://github.com/Almar/fetch-event-source.git#pr/make_web_worker_friendly",
    "@pockethost/common": "0.0.1",
    "@s-libs/micro-dash": "^14.1.0",
@ -34,16 +35,21 @@
    "@types/d3-scale": "^4.0.3",
    "@types/d3-scale-chromatic": "^3.0.0",
    "@types/js-cookie": "^3.0.2",
+    "@types/marked": "^4.0.8",
    "boolean": "^3.2.0",
    "d3-scale": "^4.0.2",
    "d3-scale-chromatic": "^3.0.0",
    "date-fns": "^2.29.3",
+    "highlight.js": "^11.7.0",
    "js-cookie": "^3.0.1",
+    "marked": "^4.2.5",
    "pocketbase": "^0.8.0",
    "pretty-bytes": "^6.0.0",
    "random-word-slugs": "^0.1.6",
    "sass": "^1.54.9",
    "svelte-highlight": "^6.2.1",
-    "type-fest": "^3.3.0"
+    "type-fest": "^3.3.0",
+    "url-pattern": "^1.0.3",
+    "vite-plugin-markdown": "^2.1.0"
  }
 }
--- a/packages/pockethost.io/src/app.d.ts
+++ b/packages/pockethost.io/src/app.d.ts
@ -7,3 +7,9 @@ declare namespace App {
  // interface Error {}
  // interface Platform {}
 }
+
+type DocPage = Metadata<{ title: string }>
+declare module '*.md' {
+  const content: DocPage
+  export = content
+}
--- a/packages/pockethost.io/src/app.html
+++ b/packages/pockethost.io/src/app.html
@ -5,6 +5,11 @@
    <link rel="icon" href="%sveltekit.assets%/favicon.png" />
    <meta name="viewport" content="width=device-width" />

+    <link
+      rel="stylesheet"
+      href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.7.0/styles/default.min.css"
+    />
+
    <link
      href="https://cdn.jsdelivr.net/npm/bootstrap@5.2.2/dist/css/bootstrap.min.css"
      rel="stylesheet"
--- a/packages/pockethost.io/src/components/Navbar.svelte
+++ b/packages/pockethost.io/src/components/Navbar.svelte
@ -89,6 +89,14 @@
          >
        </li>

+        <li class="nav-item text-center">
+          <a
+            href="/docs"
+            class="nav-link btn btn-outline-dark rounded-1 d-inline-block px-3"
+            rel="noreferrer">Docs</a
+          >
+        </li>
+
        <li class="nav-item">
          <a
            class="nav-link text-md-start text-center"
--- a/packages/pockethost.io/src/components/helpers/Protect.svelte
+++ b/packages/pockethost.io/src/components/helpers/Protect.svelte
@ -1,17 +1,18 @@
 <script lang="ts">
+  import { PUBLIC_ROUTES } from '$src/env'
  import { client } from '$src/pocketbase'
  import { warn } from '$util/logger'
-  import publicRoutes from '$util/public-routes.json'
  import { getRouter } from '$util/utilities'
  import { onMount } from 'svelte'
+
  onMount(() => {
    const { isLoggedIn } = client()
    if (isLoggedIn()) return
-    // Send user to the homepage
    const router = getRouter()

    const { pathname } = router
-    if (!publicRoutes.includes(pathname)) {
+    if (!PUBLIC_ROUTES.find((matcher) => matcher.match(pathname))) {
+      // Send user to the homepage
      warn(`${pathname} is a private route`)
      window.location.href = '/'
    }
--- a/packages/pockethost.io/src/env.ts
+++ b/packages/pockethost.io/src/env.ts
@ -1,5 +1,7 @@
 import { env as _env } from '$env/dynamic/public'
+import publicRoutes from '$util/public-routes.json'
 import { boolean } from 'boolean'
+import UrlPattern from 'url-pattern'
 import base from '../../../package.json'

 export const env = (name: string, _default: string = '') => {
@ -18,3 +20,5 @@ export const PUBLIC_APP_PROTOCOL = env('PUBLIC_APP_PROTOCOL', 'https')
 export const PUBLIC_DEBUG = envb('PUBLIC_DEBUG', false)

 export const PUBLIC_POCKETHOST_VERSION = base.version
+
+export const PUBLIC_ROUTES = publicRoutes.map((pattern) => new UrlPattern(pattern))
--- a/packages/pockethost.io/src/routes/app/instances/[instanceId]/Overview.svelte
+++ b/packages/pockethost.io/src/routes/app/instances/[instanceId]/Overview.svelte
@ -12,6 +12,7 @@
 <div class="py-4">
  <h2>Overview</h2>
  <ProvisioningStatus {status} />
+  Usage: {Math.ceil(instance.secondsThisMonth / 60)} mins
  <div>
    Running {version}
  </div>
--- a/packages/pockethost.io/src/routes/app/instances/[instanceId]/Secrets/List.svelte
+++ b/packages/pockethost.io/src/routes/app/instances/[instanceId]/Secrets/List.svelte
@ -8,7 +8,7 @@
  <section>
    <!-- display the articles in a grid, specifying the name and numerical values in a column -->
    <main>
-      {#each $items as item (item.name)}
+      {#each $items as item}
        <article style="border-color: {item.color}">
          <h2>{item.name}</h2>
          <div class="value">
--- a/packages/pockethost.io/src/routes/app/instances/[instanceId]/Secrets/Secrets.svelte
+++ b/packages/pockethost.io/src/routes/app/instances/[instanceId]/Secrets/Secrets.svelte
@ -14,6 +14,7 @@

  const cm = createCleanupManager()
  onMount(() => {
+    items.clear()
    forEach(instance.secrets || {}, (value, name) => {
      items.create({ name, value })
    })
--- a/packages/pockethost.io/src/routes/app/instances/[instanceId]/Secrets/stores.ts
+++ b/packages/pockethost.io/src/routes/app/instances/[instanceId]/Secrets/stores.ts
@ -39,6 +39,9 @@ function createItems(initialItems: SecretsArray) {

  return {
    subscribe,
+    clear: () => {
+      set([])
+    },
    // create: add an object for the item at the end of the store's array
    create: (item: SecretItem) => {
      const { name, value } = sanitize(item)
--- a/packages/pockethost.io/src/routes/docs/+layout.svelte
+++ b/packages/pockethost.io/src/routes/docs/+layout.svelte
@ -0,0 +1,43 @@
+<script lang="ts">
+  import { pages } from './pages'
+</script>
+
+<div class="docs">
+  <div class="container">
+    <div class="toc">
+      {#each Object.entries(pages) as [v, k], i}
+        <div><a class="nav-link" href={`/docs/${v}`}>{k.attributes.title}</a></div>
+      {/each}
+    </div>
+    <div class="body">
+      <slot />
+    </div>
+  </div>
+</div>
+
+<style lang="scss">
+  .title {
+    border-bottom: 1px solid gray;
+  }
+  .container {
+    margin-left: initial;
+    padding: 10px;
+    white-space: nowrap;
+    .toc {
+      white-space: normal;
+      width: 200px;
+      border-right: 1px solid gray;
+      float: left;
+      margin-right: 20px;
+      min-height: 1000px;
+      div {
+        font-weight: bold;
+      }
+    }
+    .body {
+      white-space: normal;
+      float: left;
+      width: calc(100% - 300px);
+    }
+  }
+</style>
--- a/packages/pockethost.io/src/routes/docs/+page.svelte
+++ b/packages/pockethost.io/src/routes/docs/+page.svelte
@ -0,0 +1,9 @@
+<script lang="ts">
+  import { page } from '$app/stores'
+  import { pages } from './pages'
+
+  const { pageName } = $page.params
+  const md = pages.introduction
+</script>
+
+{@html md.body}
--- a/packages/pockethost.io/src/routes/docs/[pageName]/+page.svelte
+++ b/packages/pockethost.io/src/routes/docs/[pageName]/+page.svelte
@ -0,0 +1,20 @@
+<script lang="ts">
+  import { browser } from '$app/environment'
+  import { page } from '$app/stores'
+  import hljs from 'highlight.js'
+  import { tick } from 'svelte'
+  import { pages, type PageName } from '../pages'
+
+  let md: DocPage
+  $: {
+    const { pageName } = $page.params
+    md = pages[pageName as PageName]
+    tick().then(() => {
+      if (browser) {
+        hljs.highlightAll()
+      }
+    })
+  }
+</script>
+
+{@html md.body}
--- a/packages/pockethost.io/src/routes/docs/pages/cloud_functions.md
+++ b/packages/pockethost.io/src/routes/docs/pages/cloud_functions.md
@ -0,0 +1,17 @@
+---
+title: Cloud Functions
+---
+
+# Cloud Functions
+
+PocketHost can run a Deno worker alongside your instance. In this worker, you can use the PocketHost client to listen for realtime changes or perform any other operations you desire.
+
+Update your Deno worker via [PocketHost's FTP service](ftp).
+
+## Quickstart
+
+## RPC system
+
+- Install RPC schema
+- add command names to filter table
+-
--- a/packages/pockethost.io/src/routes/docs/pages/ftp.md
+++ b/packages/pockethost.io/src/routes/docs/pages/ftp.md
@ -0,0 +1,34 @@
+---
+title: FTP Access to Instances
+---
+
+# FTP Access to Instances
+
+PocketHost allows you to access your instance data, Deno workers, and static assets via FTP.
+
+## Accessing FTP
+
+## `pb_data` directory
+
+`pb_data` contains all the standard PocketBase data files. `instance_logs.db`
+
+## `pb_public` directory
+
+## `worker` directory
+
+```bash
+ftp <instance-name>.pockethost.io
+```
+
+```ts
+import cloud_functions from './cloud_functions.md'
+import ftp from './ftp.md'
+import introduction from './introduction.md'
+
+export type PageName = keyof typeof pages
+export const pages = { introduction, cloud_functions, ftp }
+
+console.log(pages)
+```
+
+Log in using your PocketHost username and password.
--- a/packages/pockethost.io/src/routes/docs/pages/index.ts
+++ b/packages/pockethost.io/src/routes/docs/pages/index.ts
@ -0,0 +1,7 @@
+import cloud_functions from './cloud_functions.md'
+import ftp from './ftp.md'
+import instances from './instances.md'
+import introduction from './introduction.md'
+
+export type PageName = keyof typeof pages
+export const pages = { introduction, instances, cloud_functions, ftp }
--- a/packages/pockethost.io/src/routes/docs/pages/instances.md
+++ b/packages/pockethost.io/src/routes/docs/pages/instances.md
@ -0,0 +1,59 @@
+---
+title: Managing Your Instance
+---
+
+# Managing your Instance
+
+PocketHost provides a simple dashboard where you can manage your instance.
+
+## On-demand Execution
+
+PocketHost runs your PocketBase instance on-demand. That means PocketHost waits for a web request to hit PocketBase before it actually launches PocketBase and responds. This means that your instance can run on huge, beefy hardware that would be prohibitively expensive to run on your own. We can afford to do this for you because the hardware is shared with other on-demand instances.
+
+Instances are placed in hibernation after 5 seconds of idle time.
+
+![](/images/docs/2023-01-05-22-22-47.png)
+
+![](/images/docs/2023-01-05-22-21-17.png)
+
+> Note: There is a slight "first hit" penalty if PocketHost needs to spin up your idle instance before responding to a request. In practice, this is not noticeable to most users for most applications. It's nearly indistinguishable from normal network delays.
+
+## Usage Metering
+
+The free tier of PocketHost provides 100 _active minutes_ per month.
+
+![](/images/docs/2023-01-05-23-02-49.png)
+
+Because an instance stays active for a minimum of only 5 seconds per activation, 100 minutes of real, active usage is actually quite a bit. After you use your 100 minutes, you can either pay for more usage minutes, or PocketHost will move your instance to the pool of stand-by instances that get served after everyone else. Again, in practice, you will likely not even notice the difference. But if you do, there is always a paid option.
+
+## Instance Versioning
+
+By default, your instance will use the latest major+minor release of PocketBase. The PocketBase version is locked when your instance is created. We use [semver](https://semver.org/) ([npm package](https://docs.npmjs.com/cli/v6/using-npm/semver)) to determine the version range that should be allowed for your instance. When your instance is launched, it will use the latest matching version.
+
+![](/images/docs/2023-01-05-22-03-18.png)
+
+For example, if the latest version of PocketBase is `0.10.4`, your instance will automatically run with `~0.10.4`, meaning that `major=0` and `minor=10` are locked, but `patch=4 or higher` will be applied.
+
+To move between major or minor versions, please contact support. We are working on automatic migrations, but it's not easy or clear how best to implement it.
+
+## Admin access
+
+You can access your instance admin by browsing to:
+
+```
+https://<instance-name>.pockethost.io/_
+```
+
+The PocketHost dashboard also provides a handy link to do this.
+
+## Secrets
+
+Instance secrets are defined as environment variables when a [PocketHost Cloud Function Deno worker](worker) is launched. Every secret you specify here will be made available as an environment variable to the Deno process:
+
+```ts
+const MY_SECRET = Deno.env.get('MY_SECRET') || ''
+```
+
+## Realtime log
+
+## Backups and restores
--- a/packages/pockethost.io/src/routes/docs/pages/introduction.md
+++ b/packages/pockethost.io/src/routes/docs/pages/introduction.md
@ -0,0 +1,7 @@
+---
+title: Introduction
+---
+
+# PocketHost Docs
+
+## Instance
--- a/packages/pockethost.io/src/util/public-routes.json
+++ b/packages/pockethost.io/src/util/public-routes.json
@ -1,9 +1,10 @@
 [
  "/",
+  "/docs(/*)",
  "/signup",
  "/login",
  "/login/password-reset",
  "/login/password-reset/confirm",
  "/login/confirm-account",
  "/faq"
-]
+]
--- a/packages/pockethost.io/static/global.css
+++ b/packages/pockethost.io/static/global.css
@ -222,3 +222,33 @@ h6 {

  --soft-box-shadow: rgba(0, 0, 0, 0.3) 0px 7px 29px 0px;
 }
+
+.docs {
+  color: var(--bs-gray-700);
+}
+
+.docs img {
+  max-width: 100%;
+  height: auto;
+  border: 1px solid var(--bs-gray-500);
+  padding: 15px;
+}
+
+.docs h1 {
+  border-bottom: 1px solid var(--bs-gray-900);
+  padding-bottom: 10px;
+  margin-bottom: 40px;
+  color: var(--bs-gray-900);
+}
+
+.docs h2 {
+  padding-bottom: 10px;
+  margin-top: 40px;
+}
+
+.docs blockquote {
+  border-left: 3px solid var(--bs-gray-200);
+  padding: 10px;
+  background-color: var(--bs-gray-100);
+  padding-left: 20px;
+}
--- a/packages/pockethost.io/static/images/docs/2023-01-05-22-03-18.png
+++ b/packages/pockethost.io/static/images/docs/2023-01-05-22-03-18.png
--- a/packages/pockethost.io/static/images/docs/2023-01-05-22-20-30.png
+++ b/packages/pockethost.io/static/images/docs/2023-01-05-22-20-30.png
--- a/packages/pockethost.io/static/images/docs/2023-01-05-22-21-17.png
+++ b/packages/pockethost.io/static/images/docs/2023-01-05-22-21-17.png
--- a/packages/pockethost.io/static/images/docs/2023-01-05-22-22-47.png
+++ b/packages/pockethost.io/static/images/docs/2023-01-05-22-22-47.png
--- a/packages/pockethost.io/static/images/docs/2023-01-05-23-02-49.png
+++ b/packages/pockethost.io/static/images/docs/2023-01-05-23-02-49.png
--- a/packages/pockethost.io/vite.config.ts
+++ b/packages/pockethost.io/vite.config.ts
@ -1,8 +1,10 @@
+import markdown from '@dansvel/vite-plugin-markdown'
 import { sveltekit } from '@sveltejs/kit/vite'
 import type { UserConfig } from 'vite'
+import markedOptions from './marked.config.js'

 const config: UserConfig = {
-  plugins: [sveltekit()],
+  plugins: [markdown({ markedOptions }), sveltekit()],
  optimizeDeps: {
    include: ['highlight.js', 'highlight.js/lib/core']
  }
--- a/patches/@dansvel+vite-plugin-markdown+2.0.5.patch
+++ b/patches/@dansvel+vite-plugin-markdown+2.0.5.patch
@ -0,0 +1,15 @@
+diff --git a/node_modules/@dansvel/vite-plugin-markdown/dist/cjs/index.d.ts b/node_modules/@dansvel/vite-plugin-markdown/dist/cjs/index.d.ts
+index a5f9715..d84ae89 100644
+--- a/node_modules/@dansvel/vite-plugin-markdown/dist/cjs/index.d.ts
+++ b/node_modules/@dansvel/vite-plugin-markdown/dist/cjs/index.d.ts
+@@ -4,8 +4,8 @@ export interface PluginOptions {
+     markedOptions?: marked.options;
+     withOrigin?: boolean;
+ }
+-export interface Metadata {
+-    attributes: {};
+export interface Metadata<TAttributes extends {} = {}> {
+    attributes: TAttributes;
+     body: string;
+ }
+ export interface Result extends Metadata {
--- a/yarn.lock
+++ b/yarn.lock
@ -23,6 +23,15 @@
    chalk "^2.0.0"
    js-tokens "^4.0.0"

+"@dansvel/vite-plugin-markdown@^2.0.5":
+  version "2.0.5"
+  resolved "https://registry.yarnpkg.com/@dansvel/vite-plugin-markdown/-/vite-plugin-markdown-2.0.5.tgz#55cff46adb457cb654b84a424aef2e25ca635926"
+  integrity sha512-6pdL6vDffWU3E1VoYRRzpXswnghAN3W2dRW3642z9cRnKFEdLYBoxZ7qTgLYUF+kVAh4eabZe0iXEp9P1SICdw==
+  dependencies:
+    front-matter "*"
+    marked "*"
+    vite "^2.7.1"
+
 "@esbuild-kit/cjs-loader@^2.4.0":
  version "2.4.0"
  resolved "https://registry.yarnpkg.com/@esbuild-kit/cjs-loader/-/cjs-loader-2.4.0.tgz#643c4b2855a18f31cd983794536d4ff64d3b410d"
@ -52,6 +61,11 @@
  resolved "https://registry.yarnpkg.com/@esbuild/android-arm/-/android-arm-0.15.13.tgz#ce11237a13ee76d5eae3908e47ba4ddd380af86a"
  integrity sha512-RY2fVI8O0iFUNvZirXaQ1vMvK0xhCcl0gqRj74Z6yEiO1zAUa7hbsdwZM1kzqbxHK7LFyMizipfXT3JME+12Hw==

+"@esbuild/linux-loong64@0.14.54":
+  version "0.14.54"
+  resolved "https://registry.yarnpkg.com/@esbuild/linux-loong64/-/linux-loong64-0.14.54.tgz#de2a4be678bd4d0d1ffbb86e6de779cde5999028"
+  integrity sha512-bZBrLAIX1kpWelV0XemxBZllyRmM6vgFQQG2GdNb+r3Fkp0FOh1NJSvekXDs7jq70k4euu1cryLMfU+mTXlEpw==
+
 "@esbuild/linux-loong64@0.15.13":
  version "0.15.13"
  resolved "https://registry.yarnpkg.com/@esbuild/linux-loong64/-/linux-loong64-0.15.13.tgz#64e8825bf0ce769dac94ee39d92ebe6272020dfc"
@ -964,6 +978,11 @@
  resolved "https://registry.yarnpkg.com/@types/js-cookie/-/js-cookie-3.0.2.tgz#451eaeece64c6bdac8b2dde0caab23b085899e0d"
  integrity sha512-6+0ekgfusHftJNYpihfkMu8BWdeHs9EOJuGcSofErjstGPfPGEu9yTu4t460lTzzAMl2cM5zngQJqPMHbbnvYA==

+"@types/marked@^4.0.8":
+  version "4.0.8"
+  resolved "https://registry.yarnpkg.com/@types/marked/-/marked-4.0.8.tgz#b316887ab3499d0a8f4c70b7bd8508f92d477955"
+  integrity sha512-HVNzMT5QlWCOdeuBsgXP8EZzKUf0+AXzN+sLmjvaB3ZlLqO+e4u0uXrdw9ub69wBKFs+c6/pA4r9sy6cCDvImw==
+
 "@types/node@*", "@types/node@^18.11.17", "@types/node@^18.11.9", "@types/node@^18.8.2":
  version "18.11.17"
  resolved "https://registry.yarnpkg.com/@types/node/-/node-18.11.17.tgz#5c009e1d9c38f4a2a9d45c0b0c493fe6cdb4bcb5"
@ -1122,6 +1141,18 @@ are-we-there-yet@^3.0.0:
    delegates "^1.0.0"
    readable-stream "^3.6.0"

+argparse@^1.0.7:
+  version "1.0.10"
+  resolved "https://registry.yarnpkg.com/argparse/-/argparse-1.0.10.tgz#bcd6791ea5ae09725e17e5ad988134cd40b3d911"
+  integrity sha512-o5Roy6tNG4SL/FOkCAN6RzjiakZS25RLYFrcMttJqbdd8BWrnA+fGz57iN5Pb06pvBGvl5gQ0B48dJlslXvoTg==
+  dependencies:
+    sprintf-js "~1.0.2"
+
+argparse@^2.0.1:
+  version "2.0.1"
+  resolved "https://registry.yarnpkg.com/argparse/-/argparse-2.0.1.tgz#246f50f3ca78a3240f6c997e8a9bd1eac49e4b38"
+  integrity sha512-8+9WqebbFzpX9OR+Wa6O29asIogeRMzcGtAINdpMHHyAg10f05aSFVBbcEqGf/PXw1EjAZ+q2/bEBg3DvurK3Q==
+
 balanced-match@^1.0.0:
  version "1.0.2"
  resolved "https://registry.yarnpkg.com/balanced-match/-/balanced-match-1.0.2.tgz#e83e3a7e3f300b34cb9d87f615fa0cbf357690ee"
@ -1668,14 +1699,14 @@ domelementtype@^2.0.1, domelementtype@^2.2.0:
  resolved "https://registry.yarnpkg.com/domelementtype/-/domelementtype-2.3.0.tgz#5c45e8e869952626331d7aab326d01daf65d589d"
  integrity sha512-OLETBj6w0OsagBwdXnPdN0cnMfF9opN69co+7ZrbfPGrdpPVNBUj02spi6B1N7wChLQiPn4CSH/zJvXw56gmHw==

-domhandler@^4.2.0, domhandler@^4.2.2, domhandler@^4.3.1:
+domhandler@^4.0.0, domhandler@^4.2.0, domhandler@^4.2.2, domhandler@^4.3.1:
  version "4.3.1"
  resolved "https://registry.yarnpkg.com/domhandler/-/domhandler-4.3.1.tgz#8d792033416f59d68bc03a5aa7b018c1ca89279c"
  integrity sha512-GrwoxYN+uWlzO8uhUXRl0P+kHE4GtVPfYzVLcUxPL7KNdHKj66vvlhiweIHqYYXWlw+T8iLMp42Lm67ghw4WMQ==
  dependencies:
    domelementtype "^2.2.0"

-domutils@^2.8.0:
+domutils@^2.5.2, domutils@^2.8.0:
  version "2.8.0"
  resolved "https://registry.yarnpkg.com/domutils/-/domutils-2.8.0.tgz#4437def5db6e2d1f5d6ee859bd95ca7d02048135"
  integrity sha512-w96Cjofp72M5IIhpjgobBimYEfoPjx1Vx0BSX9P30WBdZW2WIKU0T1Bd0kz2eNZ9ikjKgHbEyKx8BB6H1L3h3A==
@ -1740,6 +1771,11 @@ entities@^3.0.1:
  resolved "https://registry.yarnpkg.com/entities/-/entities-3.0.1.tgz#2b887ca62585e96db3903482d336c1006c3001d4"
  integrity sha512-WiyBqoomrwMdFG1e0kqvASYfnlb0lp8M5o5Fw2OFq1hNZxxcNk8Ik0Xm7LxzBhuidnZB/UtBqVCgUz3kBOP51Q==

+entities@~2.1.0:
+  version "2.1.0"
+  resolved "https://registry.yarnpkg.com/entities/-/entities-2.1.0.tgz#992d3129cf7df6870b96c57858c249a120f8b8b5"
+  integrity sha512-hCx1oky9PFrJ611mf0ifBLBRW8lUUVRlFolb5gWRfIELabBlbp9xZvrqZLZAs+NxFnbfQoeGd8wDkygjg7U85w==
+
 env-paths@^2.2.0:
  version "2.2.1"
  resolved "https://registry.yarnpkg.com/env-paths/-/env-paths-2.2.1.tgz#420399d416ce1fbe9bc0a07c62fa68d67fd0f8f2"
@ -1762,106 +1798,233 @@ es6-promise@^3.1.2:
  resolved "https://registry.yarnpkg.com/es6-promise/-/es6-promise-3.3.1.tgz#a08cdde84ccdbf34d027a1451bc91d4bcd28a613"
  integrity sha512-SOp9Phqvqn7jtEUxPWdWfWoLmyt2VaJ6MpvP9Comy1MceMXqE6bxvaTu4iaxpYYPzhny28Lc+M87/c2cPK6lDg==

+esbuild-android-64@0.14.54:
+  version "0.14.54"
+  resolved "https://registry.yarnpkg.com/esbuild-android-64/-/esbuild-android-64-0.14.54.tgz#505f41832884313bbaffb27704b8bcaa2d8616be"
+  integrity sha512-Tz2++Aqqz0rJ7kYBfz+iqyE3QMycD4vk7LBRyWaAVFgFtQ/O8EJOnVmTOiDWYZ/uYzB4kvP+bqejYdVKzE5lAQ==
+
 esbuild-android-64@0.15.13:
  version "0.15.13"
  resolved "https://registry.yarnpkg.com/esbuild-android-64/-/esbuild-android-64-0.15.13.tgz#5f25864055dbd62e250f360b38b4c382224063af"
  integrity sha512-yRorukXBlokwTip+Sy4MYskLhJsO0Kn0/Fj43s1krVblfwP+hMD37a4Wmg139GEsMLl+vh8WXp2mq/cTA9J97g==

+esbuild-android-arm64@0.14.54:
+  version "0.14.54"
+  resolved "https://registry.yarnpkg.com/esbuild-android-arm64/-/esbuild-android-arm64-0.14.54.tgz#8ce69d7caba49646e009968fe5754a21a9871771"
+  integrity sha512-F9E+/QDi9sSkLaClO8SOV6etqPd+5DgJje1F9lOWoNncDdOBL2YF59IhsWATSt0TLZbYCf3pNlTHvVV5VfHdvg==
+
 esbuild-android-arm64@0.15.13:
  version "0.15.13"
  resolved "https://registry.yarnpkg.com/esbuild-android-arm64/-/esbuild-android-arm64-0.15.13.tgz#d8820f999314efbe8e0f050653a99ff2da632b0f"
  integrity sha512-TKzyymLD6PiVeyYa4c5wdPw87BeAiTXNtK6amWUcXZxkV51gOk5u5qzmDaYSwiWeecSNHamFsaFjLoi32QR5/w==

+esbuild-darwin-64@0.14.54:
+  version "0.14.54"
+  resolved "https://registry.yarnpkg.com/esbuild-darwin-64/-/esbuild-darwin-64-0.14.54.tgz#24ba67b9a8cb890a3c08d9018f887cc221cdda25"
+  integrity sha512-jtdKWV3nBviOd5v4hOpkVmpxsBy90CGzebpbO9beiqUYVMBtSc0AL9zGftFuBon7PNDcdvNCEuQqw2x0wP9yug==
+
 esbuild-darwin-64@0.15.13:
  version "0.15.13"
  resolved "https://registry.yarnpkg.com/esbuild-darwin-64/-/esbuild-darwin-64-0.15.13.tgz#99ae7fdaa43947b06cd9d1a1c3c2c9f245d81fd0"
  integrity sha512-WAx7c2DaOS6CrRcoYCgXgkXDliLnFv3pQLV6GeW1YcGEZq2Gnl8s9Pg7ahValZkpOa0iE/ojRVQ87sbUhF1Cbg==

+esbuild-darwin-arm64@0.14.54:
+  version "0.14.54"
+  resolved "https://registry.yarnpkg.com/esbuild-darwin-arm64/-/esbuild-darwin-arm64-0.14.54.tgz#3f7cdb78888ee05e488d250a2bdaab1fa671bf73"
+  integrity sha512-OPafJHD2oUPyvJMrsCvDGkRrVCar5aVyHfWGQzY1dWnzErjrDuSETxwA2HSsyg2jORLY8yBfzc1MIpUkXlctmw==
+
 esbuild-darwin-arm64@0.15.13:
  version "0.15.13"
  resolved "https://registry.yarnpkg.com/esbuild-darwin-arm64/-/esbuild-darwin-arm64-0.15.13.tgz#bafa1814354ad1a47adcad73de416130ef7f55e3"
  integrity sha512-U6jFsPfSSxC3V1CLiQqwvDuj3GGrtQNB3P3nNC3+q99EKf94UGpsG9l4CQ83zBs1NHrk1rtCSYT0+KfK5LsD8A==

+esbuild-freebsd-64@0.14.54:
+  version "0.14.54"
+  resolved "https://registry.yarnpkg.com/esbuild-freebsd-64/-/esbuild-freebsd-64-0.14.54.tgz#09250f997a56ed4650f3e1979c905ffc40bbe94d"
+  integrity sha512-OKwd4gmwHqOTp4mOGZKe/XUlbDJ4Q9TjX0hMPIDBUWWu/kwhBAudJdBoxnjNf9ocIB6GN6CPowYpR/hRCbSYAg==
+
 esbuild-freebsd-64@0.15.13:
  version "0.15.13"
  resolved "https://registry.yarnpkg.com/esbuild-freebsd-64/-/esbuild-freebsd-64-0.15.13.tgz#84ef85535c5cc38b627d1c5115623b088d1de161"
  integrity sha512-whItJgDiOXaDG/idy75qqevIpZjnReZkMGCgQaBWZuKHoElDJC1rh7MpoUgupMcdfOd+PgdEwNQW9DAE6i8wyA==

+esbuild-freebsd-arm64@0.14.54:
+  version "0.14.54"
+  resolved "https://registry.yarnpkg.com/esbuild-freebsd-arm64/-/esbuild-freebsd-arm64-0.14.54.tgz#bafb46ed04fc5f97cbdb016d86947a79579f8e48"
+  integrity sha512-sFwueGr7OvIFiQT6WeG0jRLjkjdqWWSrfbVwZp8iMP+8UHEHRBvlaxL6IuKNDwAozNUmbb8nIMXa7oAOARGs1Q==
+
 esbuild-freebsd-arm64@0.15.13:
  version "0.15.13"
  resolved "https://registry.yarnpkg.com/esbuild-freebsd-arm64/-/esbuild-freebsd-arm64-0.15.13.tgz#033f21de434ec8e0c478054b119af8056763c2d8"
  integrity sha512-6pCSWt8mLUbPtygv7cufV0sZLeylaMwS5Fznj6Rsx9G2AJJsAjQ9ifA+0rQEIg7DwJmi9it+WjzNTEAzzdoM3Q==

+esbuild-linux-32@0.14.54:
+  version "0.14.54"
+  resolved "https://registry.yarnpkg.com/esbuild-linux-32/-/esbuild-linux-32-0.14.54.tgz#e2a8c4a8efdc355405325033fcebeb941f781fe5"
+  integrity sha512-1ZuY+JDI//WmklKlBgJnglpUL1owm2OX+8E1syCD6UAxcMM/XoWd76OHSjl/0MR0LisSAXDqgjT3uJqT67O3qw==
+
 esbuild-linux-32@0.15.13:
  version "0.15.13"
  resolved "https://registry.yarnpkg.com/esbuild-linux-32/-/esbuild-linux-32-0.15.13.tgz#54290ea8035cba0faf1791ce9ae6693005512535"
  integrity sha512-VbZdWOEdrJiYApm2kkxoTOgsoCO1krBZ3quHdYk3g3ivWaMwNIVPIfEE0f0XQQ0u5pJtBsnk2/7OPiCFIPOe/w==

+esbuild-linux-64@0.14.54:
+  version "0.14.54"
+  resolved "https://registry.yarnpkg.com/esbuild-linux-64/-/esbuild-linux-64-0.14.54.tgz#de5fdba1c95666cf72369f52b40b03be71226652"
+  integrity sha512-EgjAgH5HwTbtNsTqQOXWApBaPVdDn7XcK+/PtJwZLT1UmpLoznPd8c5CxqsH2dQK3j05YsB3L17T8vE7cp4cCg==
+
 esbuild-linux-64@0.15.13:
  version "0.15.13"
  resolved "https://registry.yarnpkg.com/esbuild-linux-64/-/esbuild-linux-64-0.15.13.tgz#4264249281ea388ead948614b57fb1ddf7779a2c"
  integrity sha512-rXmnArVNio6yANSqDQlIO4WiP+Cv7+9EuAHNnag7rByAqFVuRusLbGi2697A5dFPNXoO//IiogVwi3AdcfPC6A==

+esbuild-linux-arm64@0.14.54:
+  version "0.14.54"
+  resolved "https://registry.yarnpkg.com/esbuild-linux-arm64/-/esbuild-linux-arm64-0.14.54.tgz#dae4cd42ae9787468b6a5c158da4c84e83b0ce8b"
+  integrity sha512-WL71L+0Rwv+Gv/HTmxTEmpv0UgmxYa5ftZILVi2QmZBgX3q7+tDeOQNqGtdXSdsL8TQi1vIaVFHUPDe0O0kdig==
+
 esbuild-linux-arm64@0.15.13:
  version "0.15.13"
  resolved "https://registry.yarnpkg.com/esbuild-linux-arm64/-/esbuild-linux-arm64-0.15.13.tgz#9323c333924f97a02bdd2ae8912b36298acb312d"
  integrity sha512-alEMGU4Z+d17U7KQQw2IV8tQycO6T+rOrgW8OS22Ua25x6kHxoG6Ngry6Aq6uranC+pNWNMB6aHFPh7aTQdORQ==

+esbuild-linux-arm@0.14.54:
+  version "0.14.54"
+  resolved "https://registry.yarnpkg.com/esbuild-linux-arm/-/esbuild-linux-arm-0.14.54.tgz#a2c1dff6d0f21dbe8fc6998a122675533ddfcd59"
+  integrity sha512-qqz/SjemQhVMTnvcLGoLOdFpCYbz4v4fUo+TfsWG+1aOu70/80RV6bgNpR2JCrppV2moUQkww+6bWxXRL9YMGw==
+
 esbuild-linux-arm@0.15.13:
  version "0.15.13"
  resolved "https://registry.yarnpkg.com/esbuild-linux-arm/-/esbuild-linux-arm-0.15.13.tgz#b407f47b3ae721fe4e00e19e9f19289bef87a111"
  integrity sha512-Ac6LpfmJO8WhCMQmO253xX2IU2B3wPDbl4IvR0hnqcPrdfCaUa2j/lLMGTjmQ4W5JsJIdHEdW12dG8lFS0MbxQ==

+esbuild-linux-mips64le@0.14.54:
+  version "0.14.54"
+  resolved "https://registry.yarnpkg.com/esbuild-linux-mips64le/-/esbuild-linux-mips64le-0.14.54.tgz#d9918e9e4cb972f8d6dae8e8655bf9ee131eda34"
+  integrity sha512-qTHGQB8D1etd0u1+sB6p0ikLKRVuCWhYQhAHRPkO+OF3I/iSlTKNNS0Lh2Oc0g0UFGguaFZZiPJdJey3AGpAlw==
+
 esbuild-linux-mips64le@0.15.13:
  version "0.15.13"
  resolved "https://registry.yarnpkg.com/esbuild-linux-mips64le/-/esbuild-linux-mips64le-0.15.13.tgz#bdf905aae5c0bcaa8f83567fe4c4c1bdc1f14447"
  integrity sha512-47PgmyYEu+yN5rD/MbwS6DxP2FSGPo4Uxg5LwIdxTiyGC2XKwHhHyW7YYEDlSuXLQXEdTO7mYe8zQ74czP7W8A==

+esbuild-linux-ppc64le@0.14.54:
+  version "0.14.54"
+  resolved "https://registry.yarnpkg.com/esbuild-linux-ppc64le/-/esbuild-linux-ppc64le-0.14.54.tgz#3f9a0f6d41073fb1a640680845c7de52995f137e"
+  integrity sha512-j3OMlzHiqwZBDPRCDFKcx595XVfOfOnv68Ax3U4UKZ3MTYQB5Yz3X1mn5GnodEVYzhtZgxEBidLWeIs8FDSfrQ==
+
 esbuild-linux-ppc64le@0.15.13:
  version "0.15.13"
  resolved "https://registry.yarnpkg.com/esbuild-linux-ppc64le/-/esbuild-linux-ppc64le-0.15.13.tgz#2911eae1c90ff58a3bd3259cb557235df25aa3b4"
  integrity sha512-z6n28h2+PC1Ayle9DjKoBRcx/4cxHoOa2e689e2aDJSaKug3jXcQw7mM+GLg+9ydYoNzj8QxNL8ihOv/OnezhA==

+esbuild-linux-riscv64@0.14.54:
+  version "0.14.54"
+  resolved "https://registry.yarnpkg.com/esbuild-linux-riscv64/-/esbuild-linux-riscv64-0.14.54.tgz#618853c028178a61837bc799d2013d4695e451c8"
+  integrity sha512-y7Vt7Wl9dkOGZjxQZnDAqqn+XOqFD7IMWiewY5SPlNlzMX39ocPQlOaoxvT4FllA5viyV26/QzHtvTjVNOxHZg==
+
 esbuild-linux-riscv64@0.15.13:
  version "0.15.13"
  resolved "https://registry.yarnpkg.com/esbuild-linux-riscv64/-/esbuild-linux-riscv64-0.15.13.tgz#1837c660be12b1d20d2a29c7189ea703f93e9265"
  integrity sha512-+Lu4zuuXuQhgLUGyZloWCqTslcCAjMZH1k3Xc9MSEJEpEFdpsSU0sRDXAnk18FKOfEjhu4YMGaykx9xjtpA6ow==

+esbuild-linux-s390x@0.14.54:
+  version "0.14.54"
+  resolved "https://registry.yarnpkg.com/esbuild-linux-s390x/-/esbuild-linux-s390x-0.14.54.tgz#d1885c4c5a76bbb5a0fe182e2c8c60eb9e29f2a6"
+  integrity sha512-zaHpW9dziAsi7lRcyV4r8dhfG1qBidQWUXweUjnw+lliChJqQr+6XD71K41oEIC3Mx1KStovEmlzm+MkGZHnHA==
+
 esbuild-linux-s390x@0.15.13:
  version "0.15.13"
  resolved "https://registry.yarnpkg.com/esbuild-linux-s390x/-/esbuild-linux-s390x-0.15.13.tgz#d52880ece229d1bd10b2d936b792914ffb07c7fc"
  integrity sha512-BMeXRljruf7J0TMxD5CIXS65y7puiZkAh+s4XFV9qy16SxOuMhxhVIXYLnbdfLrsYGFzx7U9mcdpFWkkvy/Uag==

+esbuild-netbsd-64@0.14.54:
+  version "0.14.54"
+  resolved "https://registry.yarnpkg.com/esbuild-netbsd-64/-/esbuild-netbsd-64-0.14.54.tgz#69ae917a2ff241b7df1dbf22baf04bd330349e81"
+  integrity sha512-PR01lmIMnfJTgeU9VJTDY9ZerDWVFIUzAtJuDHwwceppW7cQWjBBqP48NdeRtoP04/AtO9a7w3viI+PIDr6d+w==
+
 esbuild-netbsd-64@0.15.13:
  version "0.15.13"
  resolved "https://registry.yarnpkg.com/esbuild-netbsd-64/-/esbuild-netbsd-64-0.15.13.tgz#de14da46f1d20352b43e15d97a80a8788275e6ed"
  integrity sha512-EHj9QZOTel581JPj7UO3xYbltFTYnHy+SIqJVq6yd3KkCrsHRbapiPb0Lx3EOOtybBEE9EyqbmfW1NlSDsSzvQ==

+esbuild-openbsd-64@0.14.54:
+  version "0.14.54"
+  resolved "https://registry.yarnpkg.com/esbuild-openbsd-64/-/esbuild-openbsd-64-0.14.54.tgz#db4c8495287a350a6790de22edea247a57c5d47b"
+  integrity sha512-Qyk7ikT2o7Wu76UsvvDS5q0amJvmRzDyVlL0qf5VLsLchjCa1+IAvd8kTBgUxD7VBUUVgItLkk609ZHUc1oCaw==
+
 esbuild-openbsd-64@0.15.13:
  version "0.15.13"
  resolved "https://registry.yarnpkg.com/esbuild-openbsd-64/-/esbuild-openbsd-64-0.15.13.tgz#45e8a5fd74d92ad8f732c43582369c7990f5a0ac"
  integrity sha512-nkuDlIjF/sfUhfx8SKq0+U+Fgx5K9JcPq1mUodnxI0x4kBdCv46rOGWbuJ6eof2n3wdoCLccOoJAbg9ba/bT2w==

+esbuild-sunos-64@0.14.54:
+  version "0.14.54"
+  resolved "https://registry.yarnpkg.com/esbuild-sunos-64/-/esbuild-sunos-64-0.14.54.tgz#54287ee3da73d3844b721c21bc80c1dc7e1bf7da"
+  integrity sha512-28GZ24KmMSeKi5ueWzMcco6EBHStL3B6ubM7M51RmPwXQGLe0teBGJocmWhgwccA1GeFXqxzILIxXpHbl9Q/Kw==
+
 esbuild-sunos-64@0.15.13:
  version "0.15.13"
  resolved "https://registry.yarnpkg.com/esbuild-sunos-64/-/esbuild-sunos-64-0.15.13.tgz#f646ac3da7aac521ee0fdbc192750c87da697806"
  integrity sha512-jVeu2GfxZQ++6lRdY43CS0Tm/r4WuQQ0Pdsrxbw+aOrHQPHV0+LNOLnvbN28M7BSUGnJnHkHm2HozGgNGyeIRw==

+esbuild-windows-32@0.14.54:
+  version "0.14.54"
+  resolved "https://registry.yarnpkg.com/esbuild-windows-32/-/esbuild-windows-32-0.14.54.tgz#f8aaf9a5667630b40f0fb3aa37bf01bbd340ce31"
+  integrity sha512-T+rdZW19ql9MjS7pixmZYVObd9G7kcaZo+sETqNH4RCkuuYSuv9AGHUVnPoP9hhuE1WM1ZimHz1CIBHBboLU7w==
+
 esbuild-windows-32@0.15.13:
  version "0.15.13"
  resolved "https://registry.yarnpkg.com/esbuild-windows-32/-/esbuild-windows-32-0.15.13.tgz#fb4fe77c7591418880b3c9b5900adc4c094f2401"
  integrity sha512-XoF2iBf0wnqo16SDq+aDGi/+QbaLFpkiRarPVssMh9KYbFNCqPLlGAWwDvxEVz+ywX6Si37J2AKm+AXq1kC0JA==

+esbuild-windows-64@0.14.54:
+  version "0.14.54"
+  resolved "https://registry.yarnpkg.com/esbuild-windows-64/-/esbuild-windows-64-0.14.54.tgz#bf54b51bd3e9b0f1886ffdb224a4176031ea0af4"
+  integrity sha512-AoHTRBUuYwXtZhjXZbA1pGfTo8cJo3vZIcWGLiUcTNgHpJJMC1rVA44ZereBHMJtotyN71S8Qw0npiCIkW96cQ==
+
 esbuild-windows-64@0.15.13:
  version "0.15.13"
  resolved "https://registry.yarnpkg.com/esbuild-windows-64/-/esbuild-windows-64-0.15.13.tgz#1fca8c654392c0c31bdaaed168becfea80e20660"
  integrity sha512-Et6htEfGycjDrtqb2ng6nT+baesZPYQIW+HUEHK4D1ncggNrDNk3yoboYQ5KtiVrw/JaDMNttz8rrPubV/fvPQ==

+esbuild-windows-arm64@0.14.54:
+  version "0.14.54"
+  resolved "https://registry.yarnpkg.com/esbuild-windows-arm64/-/esbuild-windows-arm64-0.14.54.tgz#937d15675a15e4b0e4fafdbaa3a01a776a2be982"
+  integrity sha512-M0kuUvXhot1zOISQGXwWn6YtS+Y/1RT9WrVIOywZnJHo3jCDyewAc79aKNQWFCQm+xNHVTq9h8dZKvygoXQQRg==
+
 esbuild-windows-arm64@0.15.13:
  version "0.15.13"
  resolved "https://registry.yarnpkg.com/esbuild-windows-arm64/-/esbuild-windows-arm64-0.15.13.tgz#4ffd01b6b2888603f1584a2fe96b1f6a6f2b3dd8"
  integrity sha512-3bv7tqntThQC9SWLRouMDmZnlOukBhOCTlkzNqzGCmrkCJI7io5LLjwJBOVY6kOUlIvdxbooNZwjtBvj+7uuVg==

+esbuild@^0.14.27:
+  version "0.14.54"
+  resolved "https://registry.yarnpkg.com/esbuild/-/esbuild-0.14.54.tgz#8b44dcf2b0f1a66fc22459943dccf477535e9aa2"
+  integrity sha512-Cy9llcy8DvET5uznocPyqL3BFRrFXSVqbgpMJ9Wz8oVjZlh/zUSNbPRbov0VX7VxN2JH1Oa0uNxZ7eLRb62pJA==
+  optionalDependencies:
+    "@esbuild/linux-loong64" "0.14.54"
+    esbuild-android-64 "0.14.54"
+    esbuild-android-arm64 "0.14.54"
+    esbuild-darwin-64 "0.14.54"
+    esbuild-darwin-arm64 "0.14.54"
+    esbuild-freebsd-64 "0.14.54"
+    esbuild-freebsd-arm64 "0.14.54"
+    esbuild-linux-32 "0.14.54"
+    esbuild-linux-64 "0.14.54"
+    esbuild-linux-arm "0.14.54"
+    esbuild-linux-arm64 "0.14.54"
+    esbuild-linux-mips64le "0.14.54"
+    esbuild-linux-ppc64le "0.14.54"
+    esbuild-linux-riscv64 "0.14.54"
+    esbuild-linux-s390x "0.14.54"
+    esbuild-netbsd-64 "0.14.54"
+    esbuild-openbsd-64 "0.14.54"
+    esbuild-sunos-64 "0.14.54"
+    esbuild-windows-32 "0.14.54"
+    esbuild-windows-64 "0.14.54"
+    esbuild-windows-arm64 "0.14.54"
+
 esbuild@^0.15.9, esbuild@~0.15.10:
  version "0.15.13"
  resolved "https://registry.yarnpkg.com/esbuild/-/esbuild-0.15.13.tgz#7293480038feb2bafa91d3f6a20edab3ba6c108a"
@ -1905,6 +2068,11 @@ esm@^3.2.25:
  resolved "https://registry.yarnpkg.com/esm/-/esm-3.2.25.tgz#342c18c29d56157688ba5ce31f8431fbb795cc10"
  integrity sha512-U1suiZ2oDVWv4zPO56S0NcR5QriEahGtdN2OR6FiOG4WJvcjBVFB0qI4+eKoWFH483PKGuLuu6V8Z4T5g63UVA==

+esprima@^4.0.0:
+  version "4.0.1"
+  resolved "https://registry.yarnpkg.com/esprima/-/esprima-4.0.1.tgz#13b04cdb3e6c5d19df91ab6987a8695619b0aa71"
+  integrity sha512-eGuFFw7Upda+g4p+QHvnW0RyTX/SVeJBDM/gCtMARO0cLuT2HcEKnTPvhjV6aGeqrCB/sbNop0Kszm0jsaWU4A==
+
 estree-walker@^2.0.2:
  version "2.0.2"
  resolved "https://registry.yarnpkg.com/estree-walker/-/estree-walker-2.0.2.tgz#52f010178c2a4c117a7757cfe942adb7d2da4cac"
@ -2005,6 +2173,13 @@ formdata-polyfill@^4.0.10:
  dependencies:
    fetch-blob "^3.1.2"

+front-matter@*, front-matter@^4.0.0:
+  version "4.0.2"
+  resolved "https://registry.yarnpkg.com/front-matter/-/front-matter-4.0.2.tgz#b14e54dc745cfd7293484f3210d15ea4edd7f4d5"
+  integrity sha512-I8ZuJ/qG92NWX8i5x1Y8qyj3vizhXS31OxjKDu3LKP+7/qBgfIKValiZIEwoVoJKUHlhWtYrktkxV1XsX+pPlg==
+  dependencies:
+    js-yaml "^3.13.1"
+
 fs-extra@^7.0.1:
  version "7.0.1"
  resolved "https://registry.yarnpkg.com/fs-extra/-/fs-extra-7.0.1.tgz#4f189c44aa123b895f722804f55ea23eadc348e9"
@ -2208,6 +2383,11 @@ highlight.js@11.6.0:
  resolved "https://registry.yarnpkg.com/highlight.js/-/highlight.js-11.6.0.tgz#a50e9da05763f1bb0c1322c8f4f755242cff3f5a"
  integrity sha512-ig1eqDzJaB0pqEvlPVIpSSyMaO92bH1N2rJpLMN/nX396wTpDA4Eq0uK+7I/2XG17pFaaKE0kjV/XPeGt7Evjw==

+highlight.js@^11.7.0:
+  version "11.7.0"
+  resolved "https://registry.yarnpkg.com/highlight.js/-/highlight.js-11.7.0.tgz#3ff0165bc843f8c9bce1fd89e2fda9143d24b11e"
+  integrity sha512-1rRqesRFhMO/PRF+G86evnyJkCgaZFOI+Z6kdj15TA18funfoqJXvgPCLSf0SWq3SRfg1j3HlDs8o4s3EGq1oQ==
+
 htmlnano@^2.0.0:
  version "2.0.2"
  resolved "https://registry.yarnpkg.com/htmlnano/-/htmlnano-2.0.2.tgz#3e3170941e2446a86211196d740272ebca78f878"
@ -2217,6 +2397,16 @@ htmlnano@^2.0.0:
    posthtml "^0.16.5"
    timsort "^0.3.0"

+htmlparser2@^6.0.0:
+  version "6.1.0"
+  resolved "https://registry.yarnpkg.com/htmlparser2/-/htmlparser2-6.1.0.tgz#c4d762b6c3371a05dbe65e94ae43a9f845fb8fb7"
+  integrity sha512-gyyPk6rgonLFEDGoeRgQNaEUvdJ4ktTmmUh/h2t7s+M8oPpIPxgNACWa+6ESR57kXstwqPiCut0V8NRpcwgU7A==
+  dependencies:
+    domelementtype "^2.0.1"
+    domhandler "^4.0.0"
+    domutils "^2.5.2"
+    entities "^2.0.0"
+
 htmlparser2@^7.1.1:
  version "7.2.0"
  resolved "https://registry.yarnpkg.com/htmlparser2/-/htmlparser2-7.2.0.tgz#8817cdea38bbc324392a90b1990908e81a65f5a5"
@ -2447,6 +2637,14 @@ js-tokens@^4.0.0:
  resolved "https://registry.yarnpkg.com/js-tokens/-/js-tokens-4.0.0.tgz#19203fb59991df98e3a287050d4647cdeaf32499"
  integrity sha512-RdJUflcE3cUzKiMqQgsCu06FPu9UdIJO0beYbPhHN4k6apgJtifcoCtT9bcxOpYBtpD2kCM6Sbzg4CausW/PKQ==

+js-yaml@^3.13.1:
+  version "3.14.1"
+  resolved "https://registry.yarnpkg.com/js-yaml/-/js-yaml-3.14.1.tgz#dae812fdb3825fa306609a8717383c50c36a0537"
+  integrity sha512-okMH7OXXJ7YrN9Ok3/SXrnu4iX9yOk+25nqX4imS2npuvTYDmo/QEZoqwZkYaIDk3jVvBOTOIEgEhaLOynBS9g==
+  dependencies:
+    argparse "^1.0.7"
+    esprima "^4.0.0"
+
 json-parse-even-better-errors@^2.3.0:
  version "2.3.1"
  resolved "https://registry.yarnpkg.com/json-parse-even-better-errors/-/json-parse-even-better-errors-2.3.1.tgz#7c47805a94319928e05777405dc12e1f7a4ee02d"
@ -2567,6 +2765,13 @@ lines-and-columns@^1.1.6:
  resolved "https://registry.yarnpkg.com/lines-and-columns/-/lines-and-columns-1.2.4.tgz#eca284f75d2965079309dc0ad9255abb2ebc1632"
  integrity sha512-7ylylesZQ/PV29jhEDl3Ufjo6ZX7gCqJr5F7PKrqc93v7fzSymt1BpwEU8nAUXs8qzzvqhbjhK5QZg6Mt/HkBg==

+linkify-it@^3.0.1:
+  version "3.0.3"
+  resolved "https://registry.yarnpkg.com/linkify-it/-/linkify-it-3.0.3.tgz#a98baf44ce45a550efb4d49c769d07524cc2fa2e"
+  integrity sha512-ynTsyrFSdE5oZ/O9GEf00kPngmOfVwazR5GKDq6EYfhlpFug3J2zybX56a2PRRpc9P+FuSoGNAwjlbDs9jJBPQ==
+  dependencies:
+    uc.micro "^1.0.1"
+
 listenercount@~1.0.1:
  version "1.0.1"
  resolved "https://registry.yarnpkg.com/listenercount/-/listenercount-1.0.1.tgz#84c8a72ab59c4725321480c975e6508342e70937"
@ -2677,11 +2882,32 @@ make-fetch-happen@^9.1.0:
    socks-proxy-agent "^6.0.0"
    ssri "^8.0.0"

+markdown-it@^12.0.0:
+  version "12.3.2"
+  resolved "https://registry.yarnpkg.com/markdown-it/-/markdown-it-12.3.2.tgz#bf92ac92283fe983fe4de8ff8abfb5ad72cd0c90"
+  integrity sha512-TchMembfxfNVpHkbtriWltGWc+m3xszaRD0CZup7GFFhzIgQqxIfn3eGj1yZpfuflzPvfkt611B2Q/Bsk1YnGg==
+  dependencies:
+    argparse "^2.0.1"
+    entities "~2.1.0"
+    linkify-it "^3.0.1"
+    mdurl "^1.0.1"
+    uc.micro "^1.0.5"
+
+marked@*, marked@^4.2.5:
+  version "4.2.5"
+  resolved "https://registry.yarnpkg.com/marked/-/marked-4.2.5.tgz#979813dfc1252cc123a79b71b095759a32f42a5d"
+  integrity sha512-jPueVhumq7idETHkb203WDD4fMA3yV9emQ5vLwop58lu8bTclMghBWcYAavlDqIEMaisADinV1TooIFCfqOsYQ==
+
 mdn-data@2.0.14:
  version "2.0.14"
  resolved "https://registry.yarnpkg.com/mdn-data/-/mdn-data-2.0.14.tgz#7113fc4281917d63ce29b43446f701e68c25ba50"
  integrity sha512-dn6wd0uw5GsdswPFfsgMp5NSB0/aDe6fK94YJV/AJDYXL6HVLWBsxeq7js7Ad+mU2K9LAlwpk6kN2D5mwCPVow==

+mdurl@^1.0.1:
+  version "1.0.1"
+  resolved "https://registry.yarnpkg.com/mdurl/-/mdurl-1.0.1.tgz#fe85b2ec75a59037f2adfec100fd6c601761152e"
+  integrity sha512-/sKlQJCBYVY9Ers9hqzKou4H6V5UWc/M59TH2dvkt+84itfnq7uFOMLpOiOS4ujvHP4etln18fmIxA5R5fll0g==
+
 merge2@^1.3.0:
  version "1.4.1"
  resolved "https://registry.yarnpkg.com/merge2/-/merge2-1.4.1.tgz#4368892f885e907455a6fd7dc55c0c9d404990ae"
@ -3175,10 +3401,10 @@ postcss-value-parser@^4.2.0:
  resolved "https://registry.yarnpkg.com/postcss-value-parser/-/postcss-value-parser-4.2.0.tgz#723c09920836ba6d3e5af019f92bc0971c02e514"
  integrity sha512-1NNCs6uurfkVbeXG4S8JFT9t19m45ICnif8zWLd5oPSZ50QnwMfK+H3jv408d4jw/7Bttv5axS5IiHoLaVNHeQ==

-postcss@^8.4.18:
-  version "8.4.19"
-  resolved "https://registry.yarnpkg.com/postcss/-/postcss-8.4.19.tgz#61178e2add236b17351897c8bcc0b4c8ecab56fc"
-  integrity sha512-h+pbPsyhlYj6N2ozBmHhHrs9DzGmbaarbLvWipMRO7RLS+v4onj26MPFXA5OBYFxyqYhUJK456SwDcY9H2/zsA==
+postcss@^8.4.13, postcss@^8.4.18:
+  version "8.4.20"
+  resolved "https://registry.yarnpkg.com/postcss/-/postcss-8.4.20.tgz#64c52f509644cecad8567e949f4081d98349dc56"
+  integrity sha512-6Q04AXR1212bXr5fh03u8aAwbLxAQNGQ/Q1LNa0VfOI06ZAlhPHtQvE4OIdpj4kLThXilalPnmDSOD65DcHt+g==
  dependencies:
    nanoid "^3.3.4"
    picocolors "^1.0.0"
@ -3360,7 +3586,7 @@ resolve-from@^5.0.0:
  resolved "https://registry.yarnpkg.com/resolve-from/-/resolve-from-5.0.0.tgz#c35225843df8f776df21c57557bc087e9dfdfc69"
  integrity sha512-qYg9KP24dD5qka9J47d0aVky0N+b4fTU89LN9iDnjB5waksiC49rvMB0PrUJQGoTmH50XPiqOvAjDfaijGxYZw==

-resolve@^1.20.0, resolve@^1.22.1:
+resolve@^1.20.0, resolve@^1.22.0, resolve@^1.22.1:
  version "1.22.1"
  resolved "https://registry.yarnpkg.com/resolve/-/resolve-1.22.1.tgz#27cb2ebb53f91abb49470a928bba7558066ac177"
  integrity sha512-nBpuuYuY5jFsli/JIs1oldw6fOQCBioohqWZg/2hiaOybXOft4lonv85uDOKXdf8rhyK159cxU5cDcK/NKk8zw==
@ -3400,6 +3626,13 @@ rimraf@~2.4.0:
  dependencies:
    glob "^6.0.1"

+"rollup@>=2.59.0 <2.78.0":
+  version "2.77.3"
+  resolved "https://registry.yarnpkg.com/rollup/-/rollup-2.77.3.tgz#8f00418d3a2740036e15deb653bed1a90ee0cc12"
+  integrity sha512-/qxNTG7FbmefJWoeeYJFbHehJ2HNWnjkAFRKzWN/45eNBBF/r8lo992CwcJXEzyVxs5FmfId+vTSTQDb+bxA+g==
+  optionalDependencies:
+    fsevents "~2.3.2"
+
 rollup@^2.79.1:
  version "2.79.1"
  resolved "https://registry.yarnpkg.com/rollup/-/rollup-2.79.1.tgz#bedee8faef7c9f93a2647ac0108748f497f081c7"
@ -3600,6 +3833,11 @@ spawn-command@^0.0.2-1:
  resolved "https://registry.yarnpkg.com/spawn-command/-/spawn-command-0.0.2-1.tgz#62f5e9466981c1b796dc5929937e11c9c6921bd0"
  integrity sha512-n98l9E2RMSJ9ON1AKisHzz7V42VDiBQGY6PB1BwRglz99wpVsSuGzQ+jOi6lFXBGVTCrRpltvjm+/XA+tpeJrg==

+sprintf-js@~1.0.2:
+  version "1.0.3"
+  resolved "https://registry.yarnpkg.com/sprintf-js/-/sprintf-js-1.0.3.tgz#04e6926f662895354f3dd015203633b857297e2c"
+  integrity sha512-D9cPgkvLlV3t3IzL0D0YLvGA9Ahk4PcvVwUbN0dSGr1aP0Nrt4AEnTUbuGvquEC0mA64Gqt1fzirlRs5ibXx8g==
+
 sqlite3@^5.1.2:
  version "5.1.2"
  resolved "https://registry.yarnpkg.com/sqlite3/-/sqlite3-5.1.2.tgz#f50d5b1482b6972fb650daf6f718e6507c6cfb0f"
@ -3890,6 +4128,11 @@ typescript@*, typescript@^4.8.0, typescript@^4.8.3:
  resolved "https://registry.yarnpkg.com/typescript/-/typescript-4.8.4.tgz#c464abca159669597be5f96b8943500b238e60e6"
  integrity sha512-QCh+85mCy+h0IGff8r5XWzOVSbBO+KfeYrMQh7NJ58QujwcE22u+NUSmUxqF+un70P9GXKxa2HCNiTTMJknyjQ==

+uc.micro@^1.0.1, uc.micro@^1.0.5:
+  version "1.0.6"
+  resolved "https://registry.yarnpkg.com/uc.micro/-/uc.micro-1.0.6.tgz#9c411a802a409a91fc6cf74081baba34b24499ac"
+  integrity sha512-8Y75pvTYkLJW2hWQHXxoqRgV7qb9B+9vFEtidML+7koHUFapnVJAZ6cKs+Qjz5Aw3aZWHMC6u0wJE3At+nSGwA==
+
 undici@5.12.0:
  version "5.12.0"
  resolved "https://registry.yarnpkg.com/undici/-/undici-5.12.0.tgz#c758ffa704fbcd40d506e4948860ccaf4099f531"
@ -3972,6 +4215,27 @@ v8-compile-cache@^2.0.0:
  resolved "https://registry.yarnpkg.com/v8-compile-cache/-/v8-compile-cache-2.3.0.tgz#2de19618c66dc247dcfb6f99338035d8245a2cee"
  integrity sha512-l8lCEmLcLYZh4nbunNZvQCJc5pv7+RCwa8q/LdUx8u7lsWvPDKmpodJAJNwkAhJC//dFY48KuIEmjtd4RViDrA==

+vite-plugin-markdown@^2.1.0:
+  version "2.1.0"
+  resolved "https://registry.yarnpkg.com/vite-plugin-markdown/-/vite-plugin-markdown-2.1.0.tgz#3c90b91eb8c05a5701d944e9948739f514c79af1"
+  integrity sha512-eWLlrWzYZXEX3/HaXZo/KLjRpO72IUhbgaoFrbwB07ueXi6QfwqrgdZQfUcXTSofJCkN7GhErMC1K1RTAE0gGQ==
+  dependencies:
+    front-matter "^4.0.0"
+    htmlparser2 "^6.0.0"
+    markdown-it "^12.0.0"
+
+vite@^2.7.1:
+  version "2.9.15"
+  resolved "https://registry.yarnpkg.com/vite/-/vite-2.9.15.tgz#2858dd5b2be26aa394a283e62324281892546f0b"
+  integrity sha512-fzMt2jK4vQ3yK56te3Kqpkaeq9DkcZfBbzHwYpobasvgYmP2SoAr6Aic05CsB4CzCZbsDv4sujX3pkEGhLabVQ==
+  dependencies:
+    esbuild "^0.14.27"
+    postcss "^8.4.13"
+    resolve "^1.22.0"
+    rollup ">=2.59.0 <2.78.0"
+  optionalDependencies:
+    fsevents "~2.3.2"
+
 vite@^3.1.0:
  version "3.2.3"
  resolved "https://registry.yarnpkg.com/vite/-/vite-3.2.3.tgz#7a68d9ef73eff7ee6dc0718ad3507adfc86944a7"