Repository navigation
feat: redesign the website with a gallery and Markdown pages - #2
Merged
Merged
Conversation
Lato and the SciLifeLab brand colors, the SciLifeLab, NBIS and BIIF logos in the navbar, a slim footer, a banner pointing to the TissUUmaps 3 website during the beta, and the TissUUmaps logo with white letters, which also reads on a dark background.
The meta refresh dropped the query, so a link such as app/?project=<url> opened the latest app without the project. A script now redirects with the query and the fragment; the meta refresh stays as the fallback without JavaScript.
One Markdown file per project in gallery/, with a screenshot, the project file it opens in TissUUmaps, tags and the data source, so that projects can be added on GitHub without touching code (see gallery/README.md). The blog plugin reads the files; our own pages show them as cards, per tag, and each project on its own page. A missing field fails the build with the file and the field named.
Both are Markdown (MDX) pages, so that they can be edited on GitHub. A few components are available in every Markdown file without an import, for numbered steps, side-by-side boxes, buttons, figures, publications and logos. Markdown pages get an "Edit this page" link.
A video placeholder next to a short introduction, the main features and an "Open TissUUmaps" button to the latest app, followed by links to Getting started, the documentation, the gallery and the source code.
The menu now has Getting started, Documentation, Gallery and About, next to the docs version. The API docs move from their own Packages sidebar into the documentation, as a category with a generated index of the packages, read from the typedoc sidebar of each docs version. The app is linked from the pages, so the menu no longer has App and GitHub links.
cavenel
marked this pull request as ready for review
October 11, 2026 08:13
jwindhager
requested changes
Oct 11, 2026
…ent funders About opens with who develops TissUUmaps today; the history starts in 2011 and goes on to the research project of 2015. Funding lists the current funders first, BIIF among them, and the past grants as past.
scilifelab.css holds only the SciLifeLab colors and typeface as variables, so that they can be updated in one place. The theme, the components and the announcement bar use the variables; the shades of the primary color are mixed from it.
With a shorter history, the figure next to it reached into the publications and narrowed them.
Page components (the gallery pages) go to components/pages, and the components available in Markdown to components/markdown, one file per component with its styles. The button becomes a component there, with a large size for the landing page, instead of a shared CSS class that pages had to import before their own styles. gallery.ts moves to src/.
A custom navbar item type replaces the HTML string in the config. Its component lists the partners and shows the dark variant of a logo with ThemedImage, and keeps the logo sizes in its own styles.
…ding The generator and the typedoc sidebar loader move from the config to tissuumaps-docs.ts, next to the loading of the docs versions; the config only references the generator. sidebars.ts cannot hold it, as Docusaurus reads every export of the sidebars file as a sidebar.
jwindhager
approved these changes
Oct 11, 2026
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.
References and relevant issues
Depends on TissUUmaps/TissUUmaps#307 (docs moved to
docs/, published toreleases/here), for the docs this site renders.Type of change
List of changes made
gallery/(screenshot,.tm4project, tags, data source), read by the blog plugin and shown as cards, per tag and on a page per project. Adding a project needs no code (gallery/README.md,_template/); a missing field fails the build with the file and the field named.app/redirected to the latest line with a meta refresh, which dropped the query, soapp/?project=<url>opened the app without the project. A script now keeps the query and the fragment.Screenshot of the fix
Screenshots of every page (light and dark) on request; or build it locally (see Testing).
Use of AI
Claude Code was used to implement and review the changes.
Testing
pnpm run fmt:check,lint,typecheckandtestpass. Locally:TISSUUMAPS_DOCS=../TissUUmaps/docs pnpm run start.node scripts/gha-publish-docs.ts 4.0.0-beta.3 docs ../website/releasesin that checkout, thenpnpm run prepare:site --skip-apps && pnpm run build && pnpm run servehere.app/?project=<url>reaches the app of the latest line with the query.Further comments
typedoc.jsonhas noname, so typedoc titles the API index "Documentation" (the previous docs app setname: "API"). The website names the category "API" for now; with"name": "API"intypedoc.json, that override can go.tissuumaps.github.io/TissUUmaps3, which assumes the current TissUUmaps 3 website repository is renamed toTissUUmaps3when this one becomestissuumaps.github.io. Edit links already use the final repository name.