Prepare docs application with minimal Narval brand

Makefile

@@ -1,5 +1,6 @@
 include ./apps/armory/Makefile
 include ./apps/devtool/Makefile
+include ./apps/docs/Makefile
 include ./apps/policy-engine/Makefile
 include ./apps/vault/Makefile
 include ./packages/nestjs-shared/Makefile

apps/docs/Makefile

@@ -0,0 +1,4 @@
+DOCS_PROJECT_NAME := docs
+
+docs/start/dev:
+	npx nx serve ${DOCS_PROJECT_NAME} --verbose

apps/docs/docs/getting-started/_category_.json

@@ -0,0 +1,4 @@
+{
+  "label": "Getting Started",
+  "position": 1
+}

apps/docs/docs/index.mdx

@@ -0,0 +1,12 @@
+---
+id: home
+sidebar_position: 0
+sidebar_class_name: display-none
+title: Introduction
+hide_title: true
+hide_table_of_contents: true
+custom_edit_url: null
+pagination_next: null
+---
+
+TBD

apps/documentation/docs/tutorial-basics/debugging-redis-with-redis-insight.md → apps/docs/docs/tutorial-basics/debugging-redis-with-redis-insight.md

@@ -11,7 +11,6 @@ Docker image, and can be used to inspect the contents of your Redis database.
 
 You can then access Redis Insight at http://localhost:8001.
 
-> [!IMPORTANT]
 > When adding a new connection, use the hostname of the host machine, not
 > `localhost`.
 > If you're on macOS, use `host.docker.internal`.

apps/docs/docusaurus.config.ts

@@ -0,0 +1,64 @@
+import type * as Preset from '@docusaurus/preset-classic'
+import type { Config } from '@docusaurus/types'
+import { themes as prismThemes } from 'prism-react-renderer'
+
+const config: Config = {
+  title: 'Armory - Documentation',
+  tagline: 'Unicorn whales are cool',
+  favicon: 'img/favicon.ico',
+
+  url: 'https://docs.narval.xyz',
+  baseUrl: '/',
+
+  organizationName: 'narval-xyz',
+  projectName: 'armory',
+
+  onBrokenLinks: 'throw',
+  onBrokenMarkdownLinks: 'warn',
+
+  i18n: {
+    defaultLocale: 'en',
+    locales: ['en']
+  },
+
+  presets: [
+    [
+      'classic',
+      {
+        docs: {
+          routeBasePath: '/',
+          sidebarPath: './sidebars.ts'
+        },
+        blog: false,
+        theme: {
+          customCss: './src/css/custom.css'
+        }
+      } satisfies Preset.Options
+    ]
+  ],
+
+  themeConfig: {
+    image: 'img/docusaurus-social-card.jpg',
+    navbar: {
+      title: 'for Developers',
+      logo: {
+        alt: 'Narval logo',
+        src: 'img/logo.svg',
+        srcDark: 'img/logo-white.svg'
+      },
+      items: [
+        {
+          href: 'https://github.com/narval-xyz',
+          label: 'GitHub',
+          position: 'right'
+        }
+      ]
+    },
+    prism: {
+      theme: prismThemes.github,
+      darkTheme: prismThemes.dracula
+    }
+  } satisfies Preset.ThemeConfig
+}
+
+export default config

apps/documentation/project.json → apps/docs/project.json

@@ -1,13 +1,13 @@
 {
-  "name": "documentation",
+  "name": "docs",
   "$schema": "../../node_modules/nx/schemas/project-schema.json",
   "projectType": "application",
-  "sourceRoot": "apps/documentation/src",
+  "sourceRoot": "apps/docs/src",
   "targets": {
     "build": {
       "executor": "@nx-plus/docusaurus:browser",
       "options": {
-        "outputPath": "dist/apps/documentation"
+        "outputPath": "dist/apps/docs"
       }
     },
     "serve": {

apps/docs/sidebars.ts

@@ -0,0 +1,7 @@
+import type { SidebarsConfig } from '@docusaurus/plugin-content-docs'
+
+const sidebars: SidebarsConfig = {
+  docsSiderbar: [{ type: 'autogenerated', dirName: '.' }]
+}
+
+export default sidebars

apps/docs/src/css/custom.css

@@ -0,0 +1,53 @@
+@import url('https://fonts.googleapis.com/css2?family=Inter:wght@100;200;300;400;500;600;700;800;900&display=swap');
+@import url('https://fonts.googleapis.com/css2?family=Roboto+Mono&display=swap');
+@import url('https://fonts.googleapis.com/css2?family=IBM+Plex+Mono&display=swap');
+
+/* You can override the default Infima variables here. */
+:root {
+  --ifm-global-radius: 8px;
+  --ifm-code-font-size: 14px;
+  --ifm-font-family-base: 'Inter', BlinkMacSystemFont, -apple-system, 'Segoe UI', 'Roboto', 'Oxygen', 'Ubuntu',
+    'Cantarell', 'Fira Sans', 'Droid Sans', 'Helvetica Neue', 'Helvetica', 'Arial', sans-serif;
+  --ifm-font-family-monospace: 'Roboto Mono', SFMono-Regular, Menlo, Monaco, Consolas, 'Liberation Mono', 'Courier New',
+    monospace;
+  --ifm-font-size-base: 14px;
+  --ifm-base-spacing: 14px;
+  --ifm-line-height-base: 145%;
+  --ifm-font-weight-base: var(--twenty-body-regular-font-weight);
+  --ifm-color-primary: #11181c;
+  --ifm-code-font-size: 95%;
+  --docsearch-key-gradient: none !important;
+  --docsearch-key-shadow: 0 0 0 0.5px var(--docsearch-muted-color) !important;
+  --docusaurus-highlighted-code-line-bg: rgba(0, 0, 0, 0.1);
+  --ifm-toc-padding-vertical: 0.5rem;
+  --ifm-breadcrumb-border-radius: 8px;
+  --ifm-navbar-link-color: #687076;
+  --ifm-link-decoration: underline;
+
+  --ifm-heading-font-weight: 600;
+
+  --ifm-h1-font-size: 1.7rem !important;
+  --ifm-h2-font-size: 1.25rem !important;
+  --ifm-h3-font-size: 1rem !important;
+  --ifm-h4-font-size: 0.875rem !important;
+  --ifm-h5-font-size: 0.85rem !important;
+
+  --ifm-spacing-horizontal: 2rem;
+
+  --ifm-menu-link-padding-vertical: 0.2rem;
+
+  --list-items-border-color: #ebebeb;
+  --category-icon-background-color: #ebebeb;
+  --category-icon-border-color: #d6d6d6;
+  --level-1-color: #b3b3b3;
+}
+
+/* For readability concerns, you should choose a lighter palette in dark mode. */
+[data-theme='dark'] {
+  --ifm-color-primary: #fff;
+  --docusaurus-highlighted-code-line-bg: rgba(0, 0, 0, 0.3);
+  --list-items-border-color: #292929;
+  --category-icon-background-color: #292929;
+  --category-icon-border-color: #333333;
+  --level-1-color: #666666;
+}