Update site theme

Author: mvaltas

.ruby-version

@@ -0,0 +1 @@
+3.3.6

Justfile

@@ -20,3 +20,9 @@
   devcli example ping
   -devcli show-version
   -devcli show-config
+
+@bundle:
+  cd docs; bundle
+
+@docs: bundle
+  cd docs; rake

docs/Gemfile

@@ -1,4 +1,4 @@
 source "https://rubygems.org"
 
 gem "jekyll"
-gem "jekyll-theme-minimal"
+gem "just-the-docs"

docs/Gemfile.lock

@@ -3,71 +3,95 @@ GEM
   specs:
     addressable (2.8.7)
       public_suffix (>= 2.0.2, < 7.0)
-    bigdecimal (3.1.8)
+    base64 (0.3.0)
+    bigdecimal (3.3.1)
     colorator (1.1.0)
-    concurrent-ruby (1.3.4)
+    concurrent-ruby (1.3.5)
+    csv (3.3.5)
     em-websocket (0.5.3)
       eventmachine (>= 0.12.9)
       http_parser.rb (~> 0)
     eventmachine (1.2.7)
-    ffi (1.17.0)
-    ffi (1.17.0-aarch64-linux-gnu)
-    ffi (1.17.0-aarch64-linux-musl)
-    ffi (1.17.0-arm-linux-gnu)
-    ffi (1.17.0-arm-linux-musl)
-    ffi (1.17.0-arm64-darwin)
-    ffi (1.17.0-x86-linux-gnu)
-    ffi (1.17.0-x86-linux-musl)
-    ffi (1.17.0-x86_64-darwin)
-    ffi (1.17.0-x86_64-linux-gnu)
-    ffi (1.17.0-x86_64-linux-musl)
+    ffi (1.17.2)
+    ffi (1.17.2-aarch64-linux-gnu)
+    ffi (1.17.2-aarch64-linux-musl)
+    ffi (1.17.2-arm-linux-gnu)
+    ffi (1.17.2-arm-linux-musl)
+    ffi (1.17.2-arm64-darwin)
+    ffi (1.17.2-x86-linux-gnu)
+    ffi (1.17.2-x86-linux-musl)
+    ffi (1.17.2-x86_64-darwin)
+    ffi (1.17.2-x86_64-linux-gnu)
+    ffi (1.17.2-x86_64-linux-musl)
     forwardable-extended (2.6.0)
-    google-protobuf (4.29.1)
+    google-protobuf (4.33.0)
       bigdecimal
       rake (>= 13)
-    google-protobuf (4.29.1-aarch64-linux)
+    google-protobuf (4.33.0-aarch64-linux-gnu)
       bigdecimal
       rake (>= 13)
-    google-protobuf (4.29.1-arm64-darwin)
+    google-protobuf (4.33.0-aarch64-linux-musl)
       bigdecimal
       rake (>= 13)
-    google-protobuf (4.29.1-x86-linux)
+    google-protobuf (4.33.0-arm64-darwin)
       bigdecimal
       rake (>= 13)
-    google-protobuf (4.29.1-x86_64-darwin)
+    google-protobuf (4.33.0-x86-linux-gnu)
       bigdecimal
       rake (>= 13)
-    google-protobuf (4.29.1-x86_64-linux)
+    google-protobuf (4.33.0-x86-linux-musl)
+      bigdecimal
+      rake (>= 13)
+    google-protobuf (4.33.0-x86_64-darwin)
+      bigdecimal
+      rake (>= 13)
+    google-protobuf (4.33.0-x86_64-linux-gnu)
+      bigdecimal
+      rake (>= 13)
+    google-protobuf (4.33.0-x86_64-linux-musl)
       bigdecimal
       rake (>= 13)
     http_parser.rb (0.8.0)
-    i18n (1.14.6)
+    i18n (1.14.7)
       concurrent-ruby (~> 1.0)
-    jekyll (4.3.4)
+    jekyll (4.4.1)
       addressable (~> 2.4)
+      base64 (~> 0.2)
       colorator (~> 1.0)
+      csv (~> 3.0)
       em-websocket (~> 0.5)
       i18n (~> 1.0)
       jekyll-sass-converter (>= 2.0, < 4.0)
       jekyll-watch (~> 2.0)
+      json (~> 2.6)
       kramdown (~> 2.3, >= 2.3.1)
       kramdown-parser-gfm (~> 1.0)
       liquid (~> 4.0)
-      mercenary (>= 0.3.6, < 0.5)
+      mercenary (~> 0.3, >= 0.3.6)
       pathutil (~> 0.9)
       rouge (>= 3.0, < 5.0)
       safe_yaml (~> 1.0)
       terminal-table (>= 1.8, < 4.0)
       webrick (~> 1.7)
+    jekyll-include-cache (0.2.1)
+      jekyll (>= 3.7, < 5.0)
+    jekyll-remote-theme (0.4.3)
+      addressable (~> 2.0)
+      jekyll (>= 3.5, < 5.0)
+      jekyll-sass-converter (>= 1.0, <= 3.0.0, != 2.0.0)
+      rubyzip (>= 1.3.0, < 3.0)
     jekyll-sass-converter (3.0.0)
       sass-embedded (~> 1.54)
     jekyll-seo-tag (2.8.0)
       jekyll (>= 3.8, < 5.0)
-    jekyll-theme-minimal (0.2.0)
-      jekyll (> 3.5, < 5.0)
-      jekyll-seo-tag (~> 2.0)
     jekyll-watch (2.2.1)
       listen (~> 3.0)
+    json (2.15.1)
+    just-the-docs (0.10.1)
+      jekyll (>= 3.8.5)
+      jekyll-include-cache
+      jekyll-seo-tag (>= 2.0)
+      rake (>= 12.3.1)
     kramdown (2.5.1)
       rexml (>= 3.3.9)
     kramdown-parser-gfm (1.1.0)
@@ -79,70 +103,55 @@ GEM
     mercenary (0.4.0)
     pathutil (0.16.2)
       forwardable-extended (~> 2.6)
-    public_suffix (6.0.1)
-    rake (13.2.1)
+    public_suffix (6.0.2)
+    rake (13.3.0)
     rb-fsevent (0.11.2)
     rb-inotify (0.11.1)
       ffi (~> 1.0)
-    rexml (3.4.2)
-    rouge (4.5.1)
+    rexml (3.4.4)
+    rouge (4.6.1)
+    rubyzip (2.4.1)
     safe_yaml (1.0.5)
-    sass-embedded (1.83.0)
-      google-protobuf (~> 4.28)
+    sass-embedded (1.93.2)
+      google-protobuf (~> 4.31)
       rake (>= 13)
-    sass-embedded (1.83.0-aarch64-linux-android)
-      google-protobuf (~> 4.28)
-    sass-embedded (1.83.0-aarch64-linux-gnu)
-      google-protobuf (~> 4.28)
-    sass-embedded (1.83.0-aarch64-linux-musl)
-      google-protobuf (~> 4.28)
-    sass-embedded (1.83.0-aarch64-mingw-ucrt)
-      google-protobuf (~> 4.28)
-    sass-embedded (1.83.0-arm-linux-androideabi)
-      google-protobuf (~> 4.28)
-    sass-embedded (1.83.0-arm-linux-gnueabihf)
-      google-protobuf (~> 4.28)
-    sass-embedded (1.83.0-arm-linux-musleabihf)
-      google-protobuf (~> 4.28)
-    sass-embedded (1.83.0-arm64-darwin)
-      google-protobuf (~> 4.28)
-    sass-embedded (1.83.0-riscv64-linux-android)
-      google-protobuf (~> 4.28)
-    sass-embedded (1.83.0-riscv64-linux-gnu)
-      google-protobuf (~> 4.28)
-    sass-embedded (1.83.0-riscv64-linux-musl)
-      google-protobuf (~> 4.28)
-    sass-embedded (1.83.0-x86-cygwin)
-      google-protobuf (~> 4.28)
-    sass-embedded (1.83.0-x86-linux-android)
-      google-protobuf (~> 4.28)
-    sass-embedded (1.83.0-x86-linux-gnu)
-      google-protobuf (~> 4.28)
-    sass-embedded (1.83.0-x86-linux-musl)
-      google-protobuf (~> 4.28)
-    sass-embedded (1.83.0-x86-mingw-ucrt)
-      google-protobuf (~> 4.28)
-    sass-embedded (1.83.0-x86_64-cygwin)
-      google-protobuf (~> 4.28)
-    sass-embedded (1.83.0-x86_64-darwin)
-      google-protobuf (~> 4.28)
-    sass-embedded (1.83.0-x86_64-linux-android)
-      google-protobuf (~> 4.28)
-    sass-embedded (1.83.0-x86_64-linux-gnu)
-      google-protobuf (~> 4.28)
-    sass-embedded (1.83.0-x86_64-linux-musl)
-      google-protobuf (~> 4.28)
+    sass-embedded (1.93.2-aarch64-linux-android)
+      google-protobuf (~> 4.31)
+    sass-embedded (1.93.2-aarch64-linux-gnu)
+      google-protobuf (~> 4.31)
+    sass-embedded (1.93.2-aarch64-linux-musl)
+      google-protobuf (~> 4.31)
+    sass-embedded (1.93.2-arm-linux-androideabi)
+      google-protobuf (~> 4.31)
+    sass-embedded (1.93.2-arm-linux-gnueabihf)
+      google-protobuf (~> 4.31)
+    sass-embedded (1.93.2-arm-linux-musleabihf)
+      google-protobuf (~> 4.31)
+    sass-embedded (1.93.2-arm64-darwin)
+      google-protobuf (~> 4.31)
+    sass-embedded (1.93.2-riscv64-linux-android)
+      google-protobuf (~> 4.31)
+    sass-embedded (1.93.2-riscv64-linux-gnu)
+      google-protobuf (~> 4.31)
+    sass-embedded (1.93.2-riscv64-linux-musl)
+      google-protobuf (~> 4.31)
+    sass-embedded (1.93.2-x86_64-darwin)
+      google-protobuf (~> 4.31)
+    sass-embedded (1.93.2-x86_64-linux-android)
+      google-protobuf (~> 4.31)
+    sass-embedded (1.93.2-x86_64-linux-gnu)
+      google-protobuf (~> 4.31)
+    sass-embedded (1.93.2-x86_64-linux-musl)
+      google-protobuf (~> 4.31)
     terminal-table (3.0.2)
       unicode-display_width (>= 1.1.1, < 3)
     unicode-display_width (2.6.0)
     webrick (1.9.1)
 
 PLATFORMS
-  aarch64-linux
   aarch64-linux-android
   aarch64-linux-gnu
   aarch64-linux-musl
-  aarch64-mingw-ucrt
   arm-linux-androideabi
   arm-linux-gnu
   arm-linux-gnueabihf
@@ -153,22 +162,17 @@ PLATFORMS
   riscv64-linux-gnu
   riscv64-linux-musl
   ruby
-  x86-cygwin
-  x86-linux
-  x86-linux-android
   x86-linux-gnu
   x86-linux-musl
-  x86-mingw-ucrt
-  x86_64-cygwin
   x86_64-darwin
-  x86_64-linux
   x86_64-linux-android
   x86_64-linux-gnu
   x86_64-linux-musl
 
 DEPENDENCIES
   jekyll
-  jekyll-theme-minimal
+  jekyll-remote-theme
+  just-the-docs
 
 BUNDLED WITH
-   2.5.22
+   2.7.2

docs/_config.yml

@@ -25,8 +25,7 @@ description: >-
 
 logo: /assets/img/logo.png
 
-# Build settings
-theme: jekyll-theme-minimal
+theme: just-the-docs
 
 exclude:
   - CNAME
@@ -38,3 +37,7 @@ exclude:
   - vendor/cache/
   - vendor/gems/
   - vendor/ruby/
+
+search_enabled: false
+nav_enabled: true
+color_scheme: dark

docs/assets/css/style.scss

@@ -2,28 +2,50 @@
 layout: default
 ---
 
-Welcome to the **devcli** documentation site! Since this tool aims to simplify
-the development process, we need to ensure it's easy to use and understand.
+Welcome to the **devcli** documentation site! This tool aims to simplify the
+development process, so we want to make sure it's easy to use and understand.
 
 ## Installation
 
-Installation can be done using Python tools [`poetry`](https://python-poetry.org/docs/#installation)
-and [`pipx`](https://pypi.org/project/pipx/). If you don't have them installed, you can use [`homebrew`](https://brew.sh/) to install them.
+Installation can be done using Python tools [`uv`](https://docs.astral.sh/uv/)
+and [`pipx`](https://pypi.org/project/pipx/). If you don't have them installed,
+you can use [`homebrew`](https://brew.sh/) to install them. You also can use
+[`just`](https://github.com/casey/just) for some helpful shortcuts in development.
+
 
 ```bash
-$ brew install poetry
+$ brew install uv
 $ brew install pipx
+$ brew install just # optional
 ```
 
-Once you have them installed, you can install `devcli` by cloning the repository and running the following commands, like so:
+Once you have them installed, you can install `devcli` locally by cloning the
+repository and running the following commands, like so:
 
 ```bash
 $ git clone https://github.com/mvaltas/devcli.git
 $ cd devcli
-$ poetry build --format=wheel
+$ uv build --wheel
 $ pipx install --force dist/devcli*.whl
 ```
 
+When installing with `pipx` the default target will be:
+
+```bash
+${HOME}/.local/pipx/venvs/devcli/bin/devcli
+```
+
+You can add this directory to your path, like so:
+```bash
+$ export PATH=${PATH}:${HOME}/.local/pipx/venvs/devcli/bin
+```
+
+You can refresh your command hash by:
+```bash
+$ hash -r
+```
+
+
 ## Usage
 
 This tool is designed with the principle of *discoverability*, which means you