This repository was archived by the owner on May 29, 2026. It is now read-only.
feat(docs): adopt @conduction/docusaurus-preset + move to nldesign.conduction.nl#59
Merged
Merged
Conversation
…nduction.nl Mirrors the openregister docs migration (ConductionNL/openregister#1444) and the mydash one before it. The docs site now inherits brand defaults (tokens, Navbar/Footer swizzles, KvK/BTW copyright, hex-watermark hero) and gets a brand-aligned landing page composed from <DetailHero> + <WidgetShelf>. - docs/docusaurus.config.js — rewritten to call createConfig() from @conduction/docusaurus-preset. Keeps nldesign-specific bits: NL+EN i18n, mermaid theme, custom prism themes, Documentation+GitHub navbar items. Footer reduced to the brand "Conduction" column via baseFooterLinks().filter(...). minigames: false to drop the canal-footer mini-games on this product-doc surface. - docs/package.json + docs/package-lock.json — adds @conduction/docusaurus-preset@^1.4.3. - docs/src/pages/index.js — replaces the homepage with <DetailHero> (design-palette icon, orange accent, Install/Docs/GitHub CTAs) + a 3-card <WidgetShelf> (type scale, colour palette, component variants). Authored as .js not .mdx to avoid the docs-plugin/pages-plugin scan collision. - docs/static/CNAME — nldesign.app -> nldesign.conduction.nl. - .github/workflows/documentation.yml — cname: updated to nldesign.conduction.nl. Production docs URL moves from https://nldesign.app to https://nldesign.conduction.nl.
Contributor
Quality Report — ConductionNL/nldesign @
|
| Check | PHP | Vue | Security | License | Tests |
|---|---|---|---|---|---|
| lint | ✅ | ||||
| phpcs | ✅ | ||||
| phpmd | ✅ | ||||
| psalm | ✅ | ||||
| phpstan | ✅ | ||||
| phpmetrics | ✅ | ||||
| eslint | ✅ | ||||
| stylelint | ✅ | ||||
| composer | ✅ | ✅ 100/100 | |||
| npm | ✅ | ✅ 7/7 | |||
| PHPUnit | ✅ | ||||
| Newman | ⏭️ | ||||
| Playwright | ⏭️ |
Coverage: 0% (0/24 statements)
Quality workflow — 2026-05-07 20:50 UTC
Download the full PDF report from the workflow artifacts.
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 subscribe to this conversation on GitHub.
Already have an account?
Sign in.
1 participant
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.
Summary
Adopts the shared
@conduction/docusaurus-preset@^1.4.3for the NLDesign docs site and moves it tonldesign.conduction.nl. Mirrors the openregister migration (ConductionNL/openregister#1444) and the mydash one before it.The docs site now inherits brand defaults (tokens, Navbar/Footer swizzles, KvK/BTW copyright, hex-watermark hero) and gets a brand-aligned landing page composed from
<DetailHero>+<WidgetShelf>.Changes
docs/docusaurus.config.js- rewritten to callcreateConfig()from@conduction/docusaurus-preset. Keeps nldesign-specific bits: NL+EN i18n, mermaid theme, custom prism themes, Documentation+GitHub navbar items. Footer reduced to the brand "Conduction" column viabaseFooterLinks().filter(...).minigames: falseto drop the canal-footer mini-games on this product-doc surface.docs/package.json+docs/package-lock.json- adds@conduction/docusaurus-preset@^1.4.3.docs/src/pages/index.js- replaces the homepage with<DetailHero>(design-palette icon copied from the connext detail mdx, orange accent, Install/Docs/GitHub CTAs) + a 3-card<WidgetShelf>(type scale, colour palette, component variants). Authored as.jsnot.mdxto avoid the docs-plugin/pages-plugin scan collision.docs/static/CNAME-nldesign.app->nldesign.conduction.nl..github/workflows/documentation.yml-cname:updated tonldesign.conduction.nl.URL change
Production docs URL moves from
https://nldesign.apptohttps://nldesign.conduction.nl. Old hardcodednldesign.appreferences remain inDEVELOPMENT.md,test-guide.md, and severalopenspec/specs/*+openspec/changes/archive/*files (28 total). They are flagged for a follow-up sweep, not changed in this PR to keep the diff scoped.Build outcome
cd docs && npm install --legacy-peer-deps --no-audit --no-fund && npm run buildsucceeds for bothenandnllocales. Warnings only:app-downloads.jsonlookup at../../../data/app-downloads.json(harmless preset quirk; site builds without the data file)./privacy/,/terms/,/iso/(preset footer references brand legal pages that don't exist on this docs site; broken-link policy iswarn, notthrow).No
docs.excludeoverrides needed for pre-existing MDX files - all docs parse cleanly under MDX 3.Test plan
docs/build/index.htmlanddocs/build/nl/index.htmlrender correctly on a local preview.nldesign.conduction.nlDNS / GitHub Pages routing once a maintainer merges and the documentation workflow runs from thedocumentationbranch.nldesign.appreferences inDEVELOPMENT.md,test-guide.md, andopenspec/specs/**.