Release of Version 1.1.0 #86

Merged
miko merged 39 commits from development into master 2026-11-04 20:00:46 +01:00
Owner

Standalone pages with a rich page editor, a curated menu and a home page above the categories, plus callouts, an admin menu and a real 404 page.

added

  • Pages: standalone pages of rich text, such as an imprint, that admins create, edit, publish and delete under "Pages" in the titlebar (#64)
    • A page lives outside the category tree at its own address, e.g. /impressum; its slug is derived from the title and can be changed, without a redirect from the old one
    • Slugs the app uses itself, such as admin or search, are refused
    • Its visibility applies as set; a draft is seen only by admins
    • The page editor has a table block with an optional heading row; a table always spans the full width of the text or its column, and scrolls sideways where its columns would get narrower than 8rem, as on phones (#77)
    • The page editor has an image block with an optional caption: chosen, pasted or dropped, an image is uploaded at once and shown in its own format, as wide as the text at most (#67)
    • Saving a page deletes the images it no longer shows; deleting a page deletes its images
    • The page editor has a columns block: 2 or 3 columns of equal width, side by side from md on and stacked below, each holding any page block but further columns; switching from 3 to 2 columns moves the third column's blocks to the second (#68)
    • The page editor has a spacer block: empty vertical space of 1 to 20 rem, set in whole rem by typing its height or dragging its bottom edge (#73)
    • A page's content spans the page's full width, and so does its editor, which is tall enough to write in comfortably (#68)
    • Search finds pages too, for those who may see them
  • Menu: an optional menu in the titlebar that admins curate under "Menu" in the admin menu, with links to categories, guides, pages or other addresses (#65)
    • Items are added, edited, removed and sorted in one form and saved together; links to other addresses must be absolute http:// or https:// URLs and need a label
    • Without a label, an item shows the current title of what it links to
    • Each visitor only sees the items whose targets they may open; links to other addresses open in a new tab
    • Deleting a category or page removes its items; a deleted guide's item is hidden until the guide is restored
    • The item for where the visitor is shows in the accent colour: a category in its whole subtree, including its guides
    • From md up the menu stands in the titlebar; below md a button left of the logo folds it out
  • Home page: a page that always exists and whose content shows above the categories at / (#83)
    • Admins edit it under "Pages", where it always comes first, or with "Edit home page" above the categories; it cannot be deleted
    • It has the page editor's blocks, a visibility and a status, but no title or slug of its own; it starts published and empty
    • It is not found by search and offered in no menu item; the logo already leads to it

changed

  • Admin links moved from the account menu into an admin menu in the titlebar; each entry shows only to those with its permission (#66)
  • The titlebar wraps instead of centring the search: when the logo, the menu and the account leave the search too little room, it moves below them (#65)
  • Warnings in descriptions and step content are now callouts with four kinds: warning, error, note and success, each with its own icon and colour; the kind is chosen in the block's settings, and existing warnings stay warnings (#62)
  • Visibility and status are chosen from a row of buttons with icons instead of a dropdown, when editing pages, categories and a guide's properties (#75)
  • A missing page or guide shows kataba's own 404 page, with the logo hopping as the zero of "404", its own tab title and a link back to the start page, instead of Next.js's plain one (#80)

fixed

  • The callout icon is drawn in its kind's colour while editing, so it is readable in dark mode; the warning icon was black (#62)
  • Missing addresses, and pages, categories and guides hidden from guests, now answer guests and search engines with status 404 instead of 200; signed-in visitors see the same not-found page, still with status 200 (#80)
  • The logo in the titlebar is centred in its row and its wordmark stands on the baseline of the menu; it sat about 3px too high. The menu also starts twice as far from the logo (#82)

🤖 Generated with Claude Code

Standalone pages with a rich page editor, a curated menu and a home page above the categories, plus callouts, an admin menu and a real 404 page. ### added * Pages: standalone pages of rich text, such as an imprint, that admins create, edit, publish and delete under "Pages" in the titlebar (#64) * A page lives outside the category tree at its own address, e.g. `/impressum`; its slug is derived from the title and can be changed, without a redirect from the old one * Slugs the app uses itself, such as `admin` or `search`, are refused * Its visibility applies as set; a draft is seen only by admins * The page editor has a table block with an optional heading row; a table always spans the full width of the text or its column, and scrolls sideways where its columns would get narrower than 8rem, as on phones (#77) * The page editor has an image block with an optional caption: chosen, pasted or dropped, an image is uploaded at once and shown in its own format, as wide as the text at most (#67) * Saving a page deletes the images it no longer shows; deleting a page deletes its images * The page editor has a columns block: 2 or 3 columns of equal width, side by side from md on and stacked below, each holding any page block but further columns; switching from 3 to 2 columns moves the third column's blocks to the second (#68) * The page editor has a spacer block: empty vertical space of 1 to 20 rem, set in whole rem by typing its height or dragging its bottom edge (#73) * A page's content spans the page's full width, and so does its editor, which is tall enough to write in comfortably (#68) * Search finds pages too, for those who may see them * Menu: an optional menu in the titlebar that admins curate under "Menu" in the admin menu, with links to categories, guides, pages or other addresses (#65) * Items are added, edited, removed and sorted in one form and saved together; links to other addresses must be absolute `http://` or `https://` URLs and need a label * Without a label, an item shows the current title of what it links to * Each visitor only sees the items whose targets they may open; links to other addresses open in a new tab * Deleting a category or page removes its items; a deleted guide's item is hidden until the guide is restored * The item for where the visitor is shows in the accent colour: a category in its whole subtree, including its guides * From md up the menu stands in the titlebar; below md a button left of the logo folds it out * Home page: a page that always exists and whose content shows above the categories at `/` (#83) * Admins edit it under "Pages", where it always comes first, or with "Edit home page" above the categories; it cannot be deleted * It has the page editor's blocks, a visibility and a status, but no title or slug of its own; it starts published and empty * It is not found by search and offered in no menu item; the logo already leads to it ### changed * Admin links moved from the account menu into an admin menu in the titlebar; each entry shows only to those with its permission (#66) * The titlebar wraps instead of centring the search: when the logo, the menu and the account leave the search too little room, it moves below them (#65) * Warnings in descriptions and step content are now callouts with four kinds: warning, error, note and success, each with its own icon and colour; the kind is chosen in the block's settings, and existing warnings stay warnings (#62) * Visibility and status are chosen from a row of buttons with icons instead of a dropdown, when editing pages, categories and a guide's properties (#75) * A missing page or guide shows kataba's own 404 page, with the logo hopping as the zero of "404", its own tab title and a link back to the start page, instead of Next.js's plain one (#80) ### fixed * The callout icon is drawn in its kind's colour while editing, so it is readable in dark mode; the warning icon was black (#62) * Missing addresses, and pages, categories and guides hidden from guests, now answer guests and search engines with status 404 instead of 200; signed-in visitors see the same not-found page, still with status 200 (#80) * The logo in the titlebar is centred in its row and its wordmark stands on the baseline of the menu; it sat about 3px too high. The menu also starts twice as far from the logo (#82) 🤖 Generated with [Claude Code](https://claude.com/claude-code)
miko added 39 commits 2026-11-04 19:58:58 +01:00
Docker Hub carries exact versions and latest, not the minor and major
tags the table promised.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Our own Editor.js tool replaces @editorjs/warning: a callout has an
optional title, a message and a kind (warning, error, note, success),
chosen in the block's settings. Editor and renderer show the kind's icon,
border and tint, so the icon is readable in dark mode. Stored warning
blocks are read as warning callouts; no data migration.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
From the review: the editor tool reuses the parser's fallback to "note"
instead of its own copy, the list of kinds is CALLOUT_VARIANTS like the
repo's other constant lists, and all four kinds go through parse and back.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Code, DOM attribute and CSS use "kind" (CalloutKind, CALLOUT_KINDS,
data-kind), like step line kinds. Only the stored Editor.js JSON keeps
the field name "variant", as agreed in #62.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The e2e test only checked the data attribute and the icon's contrast, so
a stylesheet selector that no longer matches would have gone unnoticed.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Reviewed-on: #63
Admins create, edit, publish and delete pages under /admin/pages. A page
lives outside the category tree at /<slug>; reserved slugs (the app's own
top-level routes and a few set aside) are refused, and a test keeps the
list in step with src/app. Its visibility applies as set, a draft is seen
only by admins. The page editor adds a table block, allowed only in page
content, and search finds pages for those who may see them.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Reviewed-on: #69
Settings, Pages and Deleted guides leave the bar for a wrench dropdown
beside the user menu, shown only to admins. Both menus now share one
disclosure, which also closes when a link in it is followed.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Reviewed-on: #70
Admins link categories, guides, pages or external http(s) URLs under
/admin/menu, reached through the admin menu, and sort, edit and remove
the items in one form. An item without a label shows its target's
current title; each visitor sees only the items whose targets they may
open. Deleting a category or page removes its items; a deleted guide's
item is marked in the form and hidden until the guide is restored.

From md up the menu stands beside the logo and wraps when long; the
titlebar now floats instead of centring the search, which drops out of
the first row when the menu leaves it less than 16rem. Below md a
hamburger left of the logo folds the menu out. The entry for where the
visitor is shows in the accent colour: a category in its whole subtree,
guides included, which the guide pages publish to the menu.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Reviewed-on: #71
Admins insert images into a page's content with an optional caption.
An image chosen, pasted or dropped is uploaded at once as a page image,
stored uncropped in its own format with WebP variants without EXIF, and
shown as wide as the text at most. The block stores only the page
image's id and the caption; saving waits for an upload still running.

Saving a page deletes the page images its content no longer shows,
files included, after the transaction; deleting a page deletes its
images' files too. Upload, save and delete lock the page row. The media
route serves page images by the page's visibility and status: public
and published for anyone, internal privately, drafts for admins only.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Reviewed-on: #72
Admins lay out a page's content in 2 or 3 columns of equal width, side
by side from md on and stacked below, in the editor as on the page.
A column holds any page block but further columns. The block's settings
switch between 2 and 3 columns; going from 3 to 2 appends the third
column's blocks to the second, and saving waits for that.

Columns are an Editor.js tool of our own with one nested editor per
column (ADR 0016), built by a shared factory that gives every editor
its own tools. The format nests one level: the parser checks each
column against the same allow-list without columns, and search text,
page image references and the renderer walk into the columns, so text
in columns is found and images in columns survive saving.

Keys, paste, copy, cut and drop end at a column's border, so Enter and
Tab act in the column only. The arrow keys move into and out of the
columns through the column editors, which Editor.js does not know.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
A page's content now spans the page container instead of 48rem, and so
does the content editor, which is also taller, so editing a page, its
columns in particular, looks more like the page when read. The other
fields of the form stay narrow. Page images ask for variants to match
the wider content.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Reviewed-on: #74
Admins add empty vertical space to a page's content, 1 to 20 rem high
in whole rem, also in a column. The height is typed into the block's
field or set by dragging its bottom edge, which snaps to 1rem; focused,
the handle is a slider for the arrow keys. Read, the space between a
spacer's neighbours is its height alone, without the blocks' usual gap.

The format stores {type: "spacer", data: {height}}; the parser rounds
and clamps the height and drops a spacer without a number. The tool
keeps its number field in a shadow root, so Editor.js sees a block
without text: it would put the caret into a number field, which throws,
and leave the toolbox open. Columns and the spacer share one helper that
keeps keys, paste, copy, cut and drop inside an element.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Reviewed-on: #76
The page, category and guide properties forms pick visibility, and the
page form its status, from a row of icon buttons instead of a dropdown.
Native radios underneath post the same values, so the actions are
unchanged.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Reviewed-on: #78
A page's table is now always as wide as the text (or its column). Table
columns stay at least 8rem wide, so a table that needs more room scrolls
sideways in its container instead of squeezing its text. Stacked page
columns get a shrinkable track so a wide table scrolls there too rather
than widening the page.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Reviewed-on: #79
Unknown addresses and every notFound() now render a kataba page instead
of Next.js's default: a large "404" whose zero is the kataba mark,
hopping on its shadow (still with reduced motion), a short playful text
and a link back to the start page, translated into German. The
titlebar stays. The e2e helper expectNotFound checks the new heading.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Review follow-up: the hopping mark follows the text colour as ADR-0010
asks, the component is named after its hop, and the page sets a
translated "Page not found" tab title.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
With Cache Components the prerendered shell goes out with status 200
before a page can call notFound(), so every missing page, category,
guide and admin page answered 200. A proxy now checks guests' page
loads before rendering: when the address shows a guest nothing,
missing or hidden alike, it is rewritten to an unmatched address and
the not-found page answers 404. Signed-in visitors, client navigations
and anything the check cannot place are left to the page (ADR-0017).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- A failed check (database error, malformed address) leaves the address
  to the page instead of answering 500.
- Categories are read as id, parent, slug and visibility only, uncached
  but light; the proxy no longer pulls in the cached loaders.
- Top-level names the app does not route (/login, /guides) answer 404:
  APP_ROUTE_NAMES, kept exactly in step with src/app by a test, now
  decides what is a page slug; RESERVED_PAGE_SLUGS builds on it.
- HEAD requests are checked like GET; Next's dev endpoints are skipped.
- e2e: a guest gets 200 for a published category, guide and page.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Reviewed-on: #81
The home link was inline, so the logo sat on a text baseline and the room
left for descenders lifted it about 3px above the row's centre. As a flex
box the link centres the mark and the wordmark level with the menu.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Centred in the row, the 20px wordmark stood 2px below the baseline of the
14px menu text and read as sitting too low. Lifted by those 2px, it shares
the menu's baseline; the test now checks baselines, not box centres.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
From 22px to 44px between the wordmark and the first menu label, so the two
read as separate and a slight optical misalignment does not catch the eye.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Reviewed-on: #84
The home page is the page with the empty slug (ADR-0018): it has no
title or slug of its own, cannot be deleted, stays out of search and the
menu, and is created published and empty when an admin opens it.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Reviewed-on: #85
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
miko merged commit 13b480b5b0 into master 2026-11-04 20:00:46 +01:00
Sign in to join this conversation.
No reviewers
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
MassiveDynamic/kataba!86
No description provided.