system-repl: portal namespace for REPL workflow

Author: practicalli-johnny

docs/service-repl-workflow/portal.md

@@ -0,0 +1,23 @@
+# Portal
+
+Start Portal and capture all evaluation results over nrepl when portal middleware included, via `:repl/reloaded` or `:dev/reloaded` aliases from [Practicalli Clojure CLI Config](https://practical.li/clojure/clojure-cli/practicalli-config/).  
+
+Optionally supply a [portal theme](https://cljdoc.org/d/djblue/portal/0.37.1/doc/ui-concepts/themes).
+
+!!! EXAMPLE "Start Portal listening to all evaluations"
+```clojure title="dev/portal.clj"
+(ns portal
+  (:require
+   [portal.api :as inspect]))
+
+(def instance
+  "Open portal window if no portal sessions have been created.
+   A portal session is created when opening a portal window"
+  (or (seq (inspect/sessions))
+      (inspect/open {:portal.colors/theme :portal.colors/gruvbox})))
+
+;; Add portal as tapsource (add to clojure.core/tapset)
+(add-tap #'portal.api/submit)
+```
+
+

mkdocs.yml

@@ -134,6 +134,7 @@ nav:
       - Writing Tips: introduction/writing-tips.md
   - Service REPL Workflow:
       - service-repl-workflow/index.md
+      - Portal: service-repl-workflow/portal.md
       - Aero: service-repl-workflow/aero.md
       - Integrant:
           - service-repl-workflow/integrant/index.md