Skip to content

Site search, Markdown copies, app screenshots and a reworked homepage - #97

Merged
callumalpass merged 6 commits into
mainfrom
site-improvements
Nov 9, 2026
Merged

callumalpass merged 6 commits into
mainfrom
site-improvements

Conversation

@callumalpass

Copy link
Copy Markdown
Contributor

Improvements to mdbase.dev across search, page copies for text tools, app screenshots and the homepage.

Homepage

  • Leads with what mdbase does: keeps records as Markdown files, syncs them between devices and serves them to apps on any device.
  • Shows a real TaskNotes screenshot beside the task's Markdown file.
  • New "Open it from any device" chapter and particle scene (serve): apps on a phone or in a browser reach the collection through mdbase while your computers are off.
  • The Cloud copy vs Private chapter and the field-merge scene are removed. Private is now a pointer to the security page, and field merging is a sentence in the Sync chapter.
  • Beta notice under the title; status, source and developer facts at the end. No Obsidian mention.
  • The fixed header fades into the sky, which removes the hard dark edge.

Site

  • Pagefind site search in the header, opened with / or Ctrl/Cmd+K.
  • index.md beside every searchable page, plus /llms.txt and /llms-full.txt (scripts/build-llms.mjs), built in CI, deploy and deploy:dev.
  • Framed light and dark screenshots of TaskNotes, Editor, Reader and Writer (AppShot), used on the homepage and the Apps page.
  • Apps page: removed the "How apps reach a collection" and "Try without an account" sections, and the demo links.
  • SDK pages say "beta on npm" and recommend pinning an exact version.
  • Social card is JPEG and textures are WebP.

Checks

  • pnpm test passes, including the homepage scene tests at six widths, the build, the search index and the link check.
  • Checked in light and dark at desktop and phone widths on https://mdbase-dev.pages.dev/.

…ease status

- Say that @mdbase-dev/sdk is a beta on npm; the SDK pages still said it was unpublished
- Add a Developers link to the header and a Pagefind search dialog (/, Ctrl+K)
- Write index.md beside each page, /llms.txt and /llms-full.txt after the build
- Show Reader and Writer stills on the homepage and apps catalogue
- Add "Try without an account" (Reader preview, Writer demo); drop the TaskNotes
  demo link, which production TaskNotes no longer serves
- Name the section in docs page titles (e.g. "Get started · mdbase Reader")
- Match the footer tagline to the homepage; say who mdbase suits in Get started
- Serve the social card as a 232 KB JPEG (was a 1.2 MB PNG) and the sky grain as WebP
…age header

- Show TaskNotes, Editor, Reader and Writer in a window frame (AppShot), with
  2x captures in light and dark that follow the site theme
- Lead each app in the catalogue with its screenshot
- Remove the demo and preview links and the "Try without an account" and
  "How apps reach a collection" sections; the apps will work without an account
- Fade the fixed homepage header's backing into the sky, removing its hard edge
@callumalpass
callumalpass merged commit 36e05be into main Nov 9, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant