Skip to content
This repository was archived by the owner on May 29, 2026. It is now read-only.

feat: brand landing + dual-brand footer + in-app docs link#138

Merged
rubenvdlinde merged 1 commit into
developmentfrom
feature/landing-page-and-app-link
May 7, 2026
Merged

feat: brand landing + dual-brand footer + in-app docs link#138
rubenvdlinde merged 1 commit into
developmentfrom
feature/landing-page-and-app-link

Conversation

@rubenvdlinde

Copy link
Copy Markdown
Contributor

Summary

Two coupled changes shipping together because both depend on `@conduction/docusaurus-preset@^1.4.1`:

Docs site (mydash.conduction.nl)

  • New brand landing — replaces the Docusaurus-classic hero/HomepageFeatures with DetailHero + WidgetShelf from the preset. Mirrors the connext page at `sites/www/src/pages/apps/mydash.mdx`.
  • Hero uses the orange-accent identity: `iconColor: var(--c-orange-knvb)` + `primaryCta.tone: orange` (new in preset 1.3.0).
  • Three CTAs: Install from app store (primary, orange) → Read the docs (secondary) → View on GitHub (tertiary).
  • AppMock illustration on the right.
  • WidgetShelf renders the three product cards (BI on a register, Calendar, Werkvoorraad).
  • Footer brand: dual-brand row showing Conduction + Sendent logos in the canal-footer brand block (preset 1.3.0+ `footerBrand: { brands: [...] }`). Triad line below picks up Sendent automatically.
  • Footer links: Conduction column (from `baseFooterLinks()`) + new Sendent column. Brand `style: dark` and KvK/BTW/IBAN copyright inherit unchanged from the preset default.
  • No minigames: `minigames: false` drops the boat-sinking + kade-cyclist interactives on the canal-footer. Static skyline + canal decoration are kept.
  • Trailing slashes work: dropped the `trailingSlash: false` override so `/docs/intro/` resolves cleanly under GH Pages (the prior config 404'd /-suffix URLs).
  • `docs.path: './'` gets an explicit `exclude: ['src/**']` so plugin-content-docs and plugin-content-pages don't both process `src/pages/index.js`.
  • Removed obsolete: HomepageFeatures component, `pages/index.module.css`.
  • Sendent + Conduction logos copied into `docs/static/img/partners/`.

Nextcloud app (in-app Documentation link)

Verified locally

  • `npm install --legacy-peer-deps` clean
  • `npm run build` in `docs/`: Server + Client compiled successfully, static files generated
  • Two warnings (NOT errors) about `@conduction/docusaurus-preset/src/data/app-downloads.json` resolving — preset 1.4.1's defensive require fallback handles these and the build proceeds

Test plan

Branch policy

Filed as `feature/landing-page-and-app-link` (the previous `chore/adopt-conduction-preset` PR #137 was admin-merged through the branch-policy check; this one satisfies it organically).

Two coupled changes shipping together because they share the
@conduction/docusaurus-preset@^1.4.1 dependency bump:

DOCS SITE (mydash.conduction.nl)

- Replace docs/src/pages/index.js's Docusaurus-classic homepage with
  a brand <DetailHero> + <WidgetShelf> composition mirroring the
  connext apps/mydash.mdx page. Authored as .js (not .mdx) because
  the docs plugin's `path: './'` collides with mdx-loader on the
  pages/index.mdx route — the JSX path renders identically and
  bypasses the MDX-ESM parser quirk.
- Hero opts in to the orange-accent identity: iconColor +
  primaryCta.tone use the new tone="orange" Button variant from
  preset 1.3.0+. App-store install link as primary, docs intro as
  secondary, GitHub repo as tertiary. AppMock illustration on the
  right.
- WidgetShelf renders the three product cards (BI on a register,
  Calendar, Werkvoorraad) with the same inline panels the connext
  page uses.
- Drop the trailingSlash:false override so /docs/intro/ resolves
  cleanly under GH Pages (the prior config 404'd /-suffix URLs).
- minigames:false on the canal-footer drops the boat-sinking +
  kade-cyclist mini-games while keeping the static skyline +
  canal decoration. Kade-cyclist.js is also no longer fetched.
- footerBrand renders Conduction + Sendent logos side by side in
  the brand block; Sendent column added to footer.links beside
  the brand "Conduction" anchor. Logos copied from the parent
  app's img/ into docs/static/img/partners/.
- docs.path uses an explicit `exclude: ['src/**']` so the docs
  plugin and pages plugin don't both scan src/pages and double-
  process the landing.
- HomepageFeatures component + index.module.css removed; both
  obsolete now that the landing is preset-driven.

NEXTCLOUD APP (in-app Documentation link)

- DOCS_URL in SidebarFooter.vue and doc-url in AdminSettings.vue
  now point at https://mydash.conduction.nl/docs/intro instead
  of the marketing landing. Click context is a user inside the
  app reaching for docs, not a prospect evaluating the product.
@rubenvdlinde rubenvdlinde merged commit 38fbe29 into development May 7, 2026
37 checks passed
@rubenvdlinde rubenvdlinde deleted the feature/landing-page-and-app-link branch May 7, 2026 19:24
@github-actions

github-actions Bot commented May 7, 2026

Copy link
Copy Markdown
Contributor

Quality Report — ConductionNL/mydash @ d820525

Check PHP Vue Security License Tests
lint
phpcs
phpmd
psalm
phpstan
phpmetrics
eslint
stylelint
composer ✅ 100/100
npm ✅ 501/501
PHPUnit
Newman
Playwright ⏭️

Coverage: 90.7% (127/140 statements)


Quality workflow — 2026-05-07 19:27 UTC

Download the full PDF report from the workflow artifacts.

Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant