Repository navigation
feat: colour presets, shelldocs preview, NuGet READMEs and the issue backlog (0.1.18-alpha) - #48
Merged
Merged
Conversation
SearchState, SidebarCollapseState and MobileNavState have had no users since search, the sidebar collapse and the mobile drawer moved to shelldocs.js. Closes #46
Serves the output of shelldocs build the way static hosts do: folders serve their index.html, unknown URLs get 404.html with a 404, and a --base-href export is served under its path (read from the export by default). Replaces the unimplemented 'preview <name>' stub. Fixes #43
Graphite (the existing palette, still the default), Harbor, Lagoon, Forest, Savanna, Ember and Jacaranda, each in light and dark with text at 4.5:1 or better. The layouts render data-shelldocs-theme and tokens.css sets every colour token from it, at the specificity of :root so site overrides still win. The active sidebar item, its marker and link underlines follow the brand tokens. shelldocs init --theme takes the preset names. Shadcn, Fuma and Nextra stay as obsolete aliases of Graphite. Fixes #44
All six packages shipped the GitHub README, whose centred <picture> header and badges are HTML that nuget.org prints as text. Each project now packs its own README.md, laid out like ShellUI's. pack-dry-run fails on HTML in a package README, and the PowerShell version runs on Windows PowerShell 5.1 again (ASCII dashes, ZipFile instead of Expand-Archive).
Shewart
marked this pull request as ready for review
October 20, 2026 20:46
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Colour presets,
shelldocs preview, NuGet package pages that render, and the open issue backlog. Bumps to 0.1.18-alpha (with #40 from #47).Changes
scripts/pack-dry-runfails on HTML in a package README, and the PowerShell version runs on Windows PowerShell 5.1 again.ShellDocsOptions.Themeandshelldocs init --themedo nothing #44).o.Theme = ShellDocsTheme.Harbor: Graphite (the existing palette, still the default), Harbor (blue), Lagoon (teal), Forest (green), Savanna (amber on sand), Ember (red-orange) and Jacaranda (purple), each in light and dark, with text at 4.5:1 or better. The layouts renderdata-shelldocs-theme, andtokens.csssets every colour token from it at the specificity of:root, so site overrides still win and static exports work. The active sidebar item, its marker and link underlines follow the brand tokens.shelldocs init --themetakes the preset names.Shadcn,FumaandNextrastay as obsolete aliases of Graphite.shelldocs preview(shelldocs previewis listed but not implemented #43). Serves ashelldocs buildexport onhttp://localhost:5050the way static hosts do: folders serve theirindex.html, unknown URLs get404.htmlwith a 404, and a--base-hrefexport is served under its path, read from the export by default. The CLI now references the ASP.NET Core shared framework.titleis ignored in the sidebar #41). A folder's section uses thetitlefrom its ownmeta.json.@expressions, directive attributes and code spans stay as written.SearchState,SidebarCollapseStateandMobileNavStateare removed.Verified
shelldocs previewfrom the packed tool: the example exported with--base-href /sub/and served without flags:/redirects to/sub/, pages load, sidebar navigation stays under/sub/, unknown URLs show the not-found page with their own path.mainon the example site: the only difference is "Docs" → "Documentation", the title itsdocs/meta.jsonsets.