Skip to content
CAI
Software that uses CAICheck a score

BookStackApp/BookStack

47.8

Weak · 10 November 2026

186.5k

lines of production code

PHP

with JavaScript, TypeScript

6

measurements over time

CAI band scale
CAI trend line
CAI lens gauges

What this system is

Features

Added Arabic (ar) language translations

Added a complete set of Arabic translation files to the application, covering authentication, common UI elements, activity logs, error messages, editor interface, entity management, notifications, pagination, password resets, user preferences, and system settings. This enables the user interface to be fully localized for Arabic-speaking users.

lang · high confidence

Added data models for ZIP export structure

Introduced a set of new model classes in the \app/Exports/ZipExports/Models\ directory to define the structure of exported ZIP files. These models (\ZipExportBook\, \ZipExportChapter\, \ZipExportPage\, \ZipExportAttachment\, \ZipExportImage\, \ZipExportTag\) handle the serialization of BookStack entities into a portable format, including logic for filtering out draft pages, managing file references, and validating the integrity of the exported data structure.

app/Exports/ZipExports/Models · high confidence

Added entity context breadcrumbs and validation helpers

Users will now see bookshelves included in the breadcrumb navigation when viewing books that belong to a shelf, providing clearer context for navigation. Additionally, a new validation rule has been introduced to simplify checking for the existence of specific entity types within the system.

app/Entities · high confidence

Added local database compatibility testing suite

Developers can now run a new Docker-based testing suite in \dev/docker/db-testing\ to verify BookStack compatibility against specific MySQL and MariaDB versions (8.0, 8.4, 9.5, 10.6, 10.11, 11.4, 11.8, 12.0) before release. The setup uses a \Containerfile\ to build an environment with necessary PHP extensions and the BookStack source, while \run.sh\ automates the process of spinning up database containers, running migrations, seeding dummy content, and executing the PHP test suite against each version.

dev/docker/db-testing · high confidence

Added model traits and interfaces for creator/updater tracking

Introduced the \HasCreatorAndUpdater\ trait and \OwnableInterface\ within the Users models namespace. The trait provides Eloquent relationships to link entities to the users who created or last updated them, along with a method to identify the owner field, enabling consistent ownership tracking across models that implement the new interface.

app/Users/Models · high confidence

Automated license generation for PHP and JS dependencies

Added new PHP scripts in the dev/licensing directory to automatically generate license attribution files for both PHP (via composer.lock) and JavaScript (via node\_modules) dependencies. The system now produces structured text files (php-library-licenses.txt and js-library-licenses.txt) containing license types, copyright notices, source URLs, and license file paths for all project dependencies, streamlining compliance reporting.

dev/licensing · high confidence

Code blocks now use CodeMirror 6 with syntax highlighting and a copy button

The code block rendering in the WYSIWYG editor and on pages has been upgraded to use CodeMirror 6. This change introduces syntax highlighting for a wide range of languages (including CSS, JavaScript, PHP, HTML, Markdown, Twig, and many legacy modes), a new 'copy to clipboard' button on code blocks, and support for text direction (RTL/LTR). The editor also respects the site's dark mode theme and provides pre/post-init events for extensibility.

resources/js/code · high confidence

Default WYSIWYG editor UI configuration for modals and toolbars

The WYSIWYG editor now includes default UI definitions for its interface components. A new modal configuration defines standard dialogs for inserting or editing links, images, media, source code, table cells/rows/properties, collapsible details blocks, and an 'About' view. Additionally, a comprehensive main toolbar is provided, featuring history controls, block format menus (including callouts), inline formatting options with color pickers for text and highlights, alignment tools, list management, and an insert menu with table creation and manipulation actions.

resources/js/wysiwyg/ui/defaults · high confidence

Initial Lexical Editor API structure with content and UI modules

This change introduces the foundational API layer for the new Lexical-based WYSIWYG editor. It defines the \EditorApi\ class, which exposes two main modules: \content\ and \ui\. The \content\ module provides an \insertHtml\ method allowing users to insert HTML content at the selection, start, or end of the editor body. The \ui\ module exposes toolbar management capabilities, including \createButton\ for defining custom toolbar actions, \getMainToolbar\ to access the primary toolbar, and methods to manipulate toolbar sections and buttons. Comprehensive Jest tests are included to verify the behavior of HTML insertion and UI component creation.

resources/js/wysiwyg/api · high confidence

Initial MFA setup and verification UI

This change introduces the user interface for configuring and using multi-factor authentication. Users can now access a setup page to choose between TOTP and backup codes, generate and download backup codes, scan a QR code to configure TOTP, and verify access using their configured methods.

resources/views/mfa · high confidence

Initial database schema and role-based permissions system

This change introduces the foundational database structure for the application, establishing core tables for books, chapters, pages, images, and users. It implements a role-based access control system with default 'admin', 'editor', and 'viewer' roles, and adds support for page revisions, activity tracking, and user avatars. The schema also includes tables for settings, social accounts, and email confirmations to support initial user authentication and configuration.

database/migrations · high confidence

Initial release of BookStack v26.05-dev

This entry marks the initial commit of the BookStack application, establishing the core codebase for a documentation and information storage platform. The release includes the full Laravel application structure, configuration files (including a comprehensive \.env.example.complete\ and updated \.env.example\), and a new MIT license. It introduces a modernized development environment with Docker Compose support, TypeScript configuration, and ESLint rules, while removing legacy assets like the Gulpfile and phpspec configuration. The project is now hosted on Codeberg and includes a complete test suite configuration via PHPUnit 11.

(repo-wide) · high confidence

Initial webhook management interface

Users can now manage webhooks directly from the settings area. This update introduces a complete set of views for the webhook lifecycle: a list view with search and sorting capabilities, forms to create and edit webhook configurations, a dedicated page to confirm deletion, and a helper component that displays a sample webhook payload format to aid in configuration.

resources/views/settings/webhooks · high confidence

Integrated Lexical rich-text editor engine

The WYSIWYG editor has been replaced with the Lexical engine, introducing a new node-based architecture for content handling. This change brings improved clipboard support for copying and pasting HTML and plain text, robust drag-and-drop capabilities, and enhanced text selection and normalization logic. Users benefit from more reliable text composition across different browsers, better handling of complex content structures like tables and lists, and a more stable editing experience overall.

resources/js/wysiwyg/lexical · high confidence

Introduce configurable view blocks for sidebar sections

Users can now customize the layout of sidebar sections across the application (such as on the home page, book, chapter, page, and shelf views) by adding, removing, or reordering content blocks. This change introduces a new ViewBlock system that replaces the previous static sidebar sections with a dynamic, user-preference-driven architecture, allowing for a more personalized browsing experience.

app/View · high confidence

Introduces pluggable input abstraction for Markdown editor

The Markdown editor now supports switching between different input implementations via a new \MarkdownEditorInput\ interface. This change adds a \TextareaInput\ class that provides custom undo/redo history and keyboard shortcut handling for standard text areas, alongside a new \CodemirrorInput\ class that wraps the CodeMirror editor view. Users can now benefit from consistent editor behavior across these underlying input types, with the interface standardizing operations like text retrieval, selection management, and line iteration.

resources/js/markdown/inputs · high confidence

Introduction of a new modular component system for frontend UI elements

The application now utilizes a new, standardized JavaScript component system for managing frontend UI interactions. This change introduces a base \Component\ class and a suite of new, reusable components (such as \AjaxForm\, \Dropdown\, \Dropzone\, and \AutoSuggest\) that replace previous ad-hoc implementations. For users, this results in a more consistent and maintainable interface foundation, enabling features like AJAX-powered form submissions, improved drag-and-drop file uploads, and enhanced keyboard navigation within dropdowns and search inputs.

resources/js/components · high confidence

Introduction of the Notification Manager for activity-based alerts

A new NotificationManager class has been added to handle user notifications triggered by activity events. This component registers specific handlers for page creation, page updates, comment creation, and comment mentions, routing these events to the appropriate notification logic.

app/Activity/Notifications · high confidence

New API and Web Route Definitions

This change introduces the primary route configuration files for the application, establishing the URL structure for both the web interface and the REST API. The new \routes/api.php\ file defines endpoints for managing core entities (pages, chapters, books, shelves), attachments, comments, tags, users, roles, and system status, along with specific export formats (HTML, PDF, Markdown, ZIP) and search capabilities. The \routes/web.php\ file sets up the corresponding web routes for user-facing actions, including authentication, content creation and editing, image and attachment management, and administrative functions like the recycle bin and permissions.

routes · high confidence

New API documentation views with HTML/JSON download options

Users can now view the API documentation through new Blade templates (resources/views/api-docs/index.blade.php and download.blade.php). The main documentation page features a sticky sidebar for navigation and includes buttons to download the full documentation as either HTML or JSON. The download view provides a standalone, styled HTML representation of the API docs, including getting started sections and detailed endpoint information.

resources/views/api-docs · high confidence

New API documentation, token management, and core API infrastructure

This change introduces a new API documentation system that allows users to view and download API reference materials as HTML or JSON, generated automatically from controller code and static examples. It also adds a dedicated interface for managing API tokens, enabling users to create, edit, and delete tokens with expiration dates and permission checks. Under the hood, the API now uses a new \ApiTokenGuard\ for authentication, a \ListingResponseBuilder\ for consistent pagination, filtering, and sorting of list endpoints, and an \ApiEntityListFormatter\ to standardize how entity data is returned in API responses.

app/Api · high confidence

New BookStack API and Entity Controllers

This change introduces a new set of API and web controllers for the core BookStack entities: Book, Bookshelf, Chapter, and Page. The new API controllers (e.g., BookApiController, PageApiController) provide structured endpoints for listing, creating, reading, updating, and deleting these entities, including support for HTML descriptions, cover images, and nested comment trees. The corresponding web controllers (e.g., BookController, PageController) handle the user-facing views, draft management, and permission checks. This refactoring separates API logic from web logic and introduces new query classes for data retrieval.

app/Entities/Controllers · high confidence

New Facades for Activity Logging and Theme System

Added new Laravel facades to provide static access to the activity logging and theme subsystems. The Activity facade exposes the ActivityLogger for recording system and audit log events, while the Theme facade provides access to the ThemeService, enabling the new backend theme system.

app/Facades · high confidence

New LDAP and external authentication session guards

Added new authentication guard classes in app/Access/Guards to support external identity providers. The LdapSessionGuard implements full LDAP login logic, including credential validation, user creation, group syncing, and avatar handling. The ExternalBaseSessionGuard provides a simplified base implementation for external auth flows (such as SAML2/OIDC) that do not fit the standard Laravel guard model, while AsyncExternalBaseSessionGuard offers a thin wrapper for async external authentication scenarios.

app/Access/Guards · high confidence

New Lexical-based WYSIWYG editor for pages, descriptions, and comments

The application now uses a new Lexical-based WYSIWYG editor for page content, chapter/book/shelf descriptions, and comments. This editor supports rich text features including headings, lists, tables, code blocks, images, links, and mentions (in comments). It provides distinct editor instances for different contexts: a full-featured editor for page content, a basic editor for descriptions, and a comment-specific editor with mention support. The implementation includes history/undo support, keyboard shortcuts, auto-links, and various UI components like toolbars and modals.

resources/js/wysiwyg · high confidence

New My Account section with profile, auth, interface, and shortcut management

Users now have a dedicated 'My Account' area to manage their profile details (name, email, avatar), authentication settings (password changes, MFA, social account connections), interface preferences (language, light/dark mode), and customizable keyboard shortcuts. This section also includes a self-service account deletion flow with ownership migration options for administrators.

resources/views/users/account · high confidence

New OIDC authentication implementation with PKCE and JWT validation

The OIDC authentication flow has been replaced with a new implementation that adds PKCE support for enhanced security, validates ID tokens and UserInfo responses against OIDC specifications, and supports both JSON and JWT-signed UserInfo responses. The new code introduces dedicated classes for handling access tokens, ID tokens, JWT signing keys, and user details, along with automatic provider discovery from the issuer's well-known endpoint.

app/Access/Oidc · high confidence

New WYSIWYG UI framework blocks for toolbar and form controls

The WYSIWYG editor now includes a new set of UI component blocks in the framework layer, enabling richer toolbar and form interactions. Users can now use color pickers with custom color storage, dropdown menus with hover/aside support, and format menus that dynamically update their toggle labels based on selection. The editor also features a visual table creator that allows selecting dimensions via a grid and inserts tables with automatic column widths, as well as a link field that provides an autocomplete datalist of document headings for quick internal linking. Additional components include an overflow container for managing toolbar space, action fields for input-button pairs, and specialized buttons for format previews and external content loading.

resources/js/wysiwyg/ui/framework/blocks · high confidence

The WYSIWYG editor now includes dedicated service modules for core interaction features. Auto-linking is handled by a new service that converts URLs typed after a space or Enter into clickable links. Mention support has been added, allowing users to insert user mentions via the '@' key with keyboard navigation. A comprehensive keyboard shortcut system is introduced, supporting standard formatting (bold, italic, lists, headings) and extended actions (save draft, save page) with Mac/Windows modifier handling and keyCode fallbacks for non-Latin keyboards. Additionally, new services manage drop/paste operations (including image uploads and template inserts), mouse click handling for complex nodes, and selection indicators for collapsible details blocks.

resources/js/wysiwyg/services · high confidence

New WYSIWYG helper utilities for dropdowns, drag interactions, and table management

The WYSIWYG editor framework now includes a set of new helper modules to support advanced UI interactions. A \DropDownManager\ handles dropdown positioning and lifecycle, including support for right-to-left (RTL) layouts. A \MouseDragTracker\ provides a reusable abstraction for tracking mouse drag events, which is utilized by the new \NodeResizer\ (for resizing images and media nodes) and \TableResizer\ (for resizing table columns and rows). Additionally, \TableSelectionHandler\ manages table selection states, and \TaskListHandler\ enables toggling of task list items via click events outside the checkbox area.

resources/js/wysiwyg/ui/framework/helpers · high confidence

New WYSIWYG toolbar buttons for alignment, formatting, and tables

The WYSIWYG editor now includes a comprehensive set of default toolbar buttons for text and block manipulation. Users can apply block alignments (left, center, right, justify) and text direction (LTR/RTL). Inline formatting options include bold, italic, underline, strikethrough, superscript, subscript, inline code, and text/highlight colors. Block-level controls allow toggling headings (H2–H5), blockquotes, paragraphs, and callouts (info, danger, warning, success). List management features bullet, numbered, and task lists with indent/outdent controls. Object insertion supports links, images, media, diagrams, horizontal rules, code blocks, and collapsible details blocks. Table editing capabilities include inserting/deleting rows and columns, merging cells, setting row/column headers, and accessing table/row/cell properties forms.

resources/js/wysiwyg/ui/defaults/buttons · high confidence

New ZIP import and export functionality for books, chapters, and pages

Users can now export and import BookStack content (books, chapters, and pages) as ZIP archives. The new \ZipExports\ module handles the full lifecycle: exporting entities and their associated images and attachments into a structured ZIP file, validating incoming ZIP files for format, size, and MIME types, and importing them while preserving internal cross-references and drawing IDs. This enables portable backups and migration of documentation structures between instances.

app/Exports/ZipExports · high confidence

New ZIP import capability and refactored export formatting

Users can now import content via ZIP files using a new ImportRepo that handles upload, validation, and execution of imports for pages, chapters, and books, including permission checks and activity logging. The export system has been refactored with a new ExportFormatter class that standardizes how pages, chapters, and books are converted to self-contained HTML and PDF, while the PdfGenerator now supports custom DOMPDF font loading from the storage directory and improved cleanup of temporary files during command-based PDF generation.

app/Exports · high confidence

New ZIP import workflow and export view templates

Users can now import content via ZIP files through a new import interface (resources/views/exports/import.blade.php) that supports file selection, validation error display, and a list of pending imports. The import process includes a confirmation step (import-show.blade.php) where users can review import details, resolve errors, select a parent location for pages or chapters, and execute or delete the import. Additionally, new export view templates have been added for books (book.blade.php), chapters (chapter.blade.php), and pages (page.blade.php), which render content with proper HTML description handling and include navigation menus for hierarchical content.

resources/views/exports · high confidence

New activity logging, comment threading, and entity watch tools

This change introduces a suite of new backend tools in the Activity module to support enhanced activity tracking and user notifications. The ActivityLogger now centralizes activity creation, triggering notifications, dispatching webhooks, and emitting theme events. Comment functionality is upgraded with a CommentTree and CommentTreeNode to support nested, threaded discussions, including archive states. Entity interactions are improved via EntityWatchers to determine relevant notification recipients based on hierarchical watch levels, and UserEntityWatchOptions to manage per-user watch settings. Additional utilities include MentionParser for extracting user IDs from HTML, TagClassGenerator for producing CSS classes from entity and parent tags, IpFormatter for masking IP addresses in logs, and WebhookFormatter for structuring outgoing webhook payloads with detailed event context.

app/Activity/Tools · high confidence

New activity management controllers for comments, tags, webhooks, and more

This change introduces a suite of new controllers in the Activity module that enable users to manage comments, tags, webhooks, favorites, and system watches. Users can now create, read, update, and delete comments (including archiving and reply trees) via both the web interface and API, view and filter system audit logs, manage tag listings and suggestions, configure webhook endpoints for event notifications, toggle entity watch levels for notifications, and manage their personal favorite items. These controllers handle the specific request validation, permission checks, and view rendering for these activity-related features.

app/Activity/Controllers · high confidence

New activity tracking and notification system

This change introduces a comprehensive activity logging and notification framework. It adds a new \ActivityQueries\ class to retrieve and filter activity logs for the system, entities, and users, including deduplication of similar events. A new \ActivityType\ enum defines specific event types such as page, book, comment, and user actions. The \CommentRepo\ is updated to log comment creation, updates, and archiving as activities. A new \DispatchWebhookJob\ enables asynchronous webhook dispatching for activity events with SSR URL validation. Additionally, a \TagRepo\ is added to manage tag associations and suggestions, and \WatchLevels\ provides configuration for user notification preferences (ignore, new content, updates, comments).

app/Activity · high confidence

New and updated Artisan commands for system administration

This update introduces a comprehensive suite of new Artisan commands for managing BookStack, replacing the legacy 'inspire' command with 'bookstack:clear-activity'. Administrators can now use 'bookstack:assign-sort-rule' to apply sorting rules to books, 'bookstack:cleanup-images' to remove unused images, and 'bookstack:clear-revisions' or 'bookstack:clear-views' to purge historical data. User management is enhanced with 'bookstack:create-admin' (supporting external auth IDs and initial admin setup), 'bookstack:delete-users', 'bookstack:refresh-avatar', and 'bookstack:reset-mfa'. Maintenance tasks include 'bookstack:copy-shelf-permissions' to cascade permissions, 'bookstack:regenerate-permissions', 'bookstack:regenerate-references', and 'bookstack:regenerate-search' to rebuild indexes. Additionally, 'bookstack:update-url' allows for bulk URL replacement in the database, 'bookstack:db-utf8mb4' generates SQL for database encoding upgrades, and 'bookstack:install-module' facilitates theme module installation.

app/Console/Commands · high confidence

New app structure and system read API endpoint

The application has been restructured with a new namespace (BookStack\\App) containing core components like the Application bootstrap, HomeController, and MetaController. A new system read API endpoint is now available, providing instance details such as version, name, logo, and base URL. The homepage controller now supports configurable views (default, books, bookshelves, or a specific page) with sorting and pagination. Additionally, PWA manifest generation has been updated to respect dark mode settings and orientation, and helper functions for versioned assets, user context, and permissions have been centralized.

app/App · high confidence

New attachment and image management APIs

The application now exposes dedicated REST APIs for managing attachments and images. The Attachment API allows users to list, create, read, update, and delete file attachments linked to pages, including support for streaming file content as base64. The Image Gallery API provides similar CRUD operations for gallery images and Draw.io diagrams, with specific endpoints to read raw image data by ID or URL. These endpoints enforce existing page and attachment permissions, ensuring users can only interact with resources they have access to.

app/Uploads/Controllers · high confidence

New audit log and maintenance interface in settings

The settings area now includes a dedicated audit log view that allows administrators to filter activity records by event type, date range, user, and IP address, with results displayed in a responsive table. Additionally, a new maintenance section has been added to the settings layout, providing tools to manage the recycle bin, clean up unused images, send test emails, and regenerate entity references.

resources/views/settings · high confidence

New book sorting and auto-sort rule system

Users can now manage book content order through a new dedicated sorting interface and a system of reusable sort rules. The BookSortController handles manual reordering via drag-and-drop maps and allows assigning auto-sort rules to individual books. Administrators can create, edit, and delete SortRules in the settings, defining sequences of sorting operations (such as by name, date, or chapter position) via the SortRuleController. The BookSorter applies these rules to automatically order books and pages, while SortSetOperationComparisons provides the specific logic for each sort type, including improved non-ASCII character handling for name-based sorts.

app/Sorting · high confidence

New book, page, and chapter export and import endpoints

This change introduces new controllers in the app/Exports/Controllers directory that enable users to export books, pages, and chapters to PDF, HTML, plain text, Markdown, and ZIP formats via both the web interface and API. The controllers enforce the ContentExport permission and apply rate limiting to the web exports. Additionally, new ImportController and ImportApiController classes allow users with the ContentImport permission to upload, validate, and run ZIP imports for pages and chapters, including specifying a parent entity for the imported content.

app/Exports/Controllers · high confidence

New chapter management views added

Added new Blade templates for chapter operations, including show, create, edit, delete, copy, move, permissions, and references. These views provide the user interface for managing chapters within books, featuring breadcrumbs, forms for editing and copying, permission settings, and navigation controls.

resources/views/chapters · high confidence

New comment system with threaded replies and archiving

The comments section has been redesigned to support threaded discussions, allowing users to reply to specific comments in a nested structure. A new tabbed interface separates active comments from archived ones, enabling users to hide or restore comment threads. The system now includes granular permissions for creating, updating, and deleting comments, along with a new form for adding comments that supports replying to existing threads and referencing page content.

resources/views/comments · high confidence

New common UI components and view blocks

This change introduces a set of reusable Blade view components in the common directory to standardize the user interface. Users will see new, consistent rendering for activity feeds (activity-item, activity-list), a reusable confirmation dialog for actions, and a toggle for dark mode preferences. Additionally, new components support paginated and extended detailed listings, a loading icon, a sort control dropdown, and a status indicator. The introduction of view blocks allows for dynamic, location-based content injection into layouts.

resources/views/common · high confidence

New decorator components for code blocks, diagrams, and mentions

The WYSIWYG editor now includes dedicated decorator implementations for handling code blocks, diagrams, and user mentions. CodeBlockDecorator enables inline code editing with dynamic height adjustment and double-click access to a full code editor. DiagramDecorator provides click and double-click interactions for diagram nodes, allowing users to select and edit diagrams. MentionDecorator introduces a searchable user selector with keyboard navigation, debounced search results, and proper selection handling, improving the stability and usability of mentioning users in content.

resources/js/wysiwyg/ui/decorators · high confidence

New dummy and large content seeders for testing

Added DummyContentSeeder and LargeContentSeeder to the database/seeders directory to facilitate testing with pre-populated data. The DummyContentSeeder creates a small set of books, chapters, pages, and users with specific roles and API permissions, while the LargeContentSeeder generates a single large book with many chapters and pages to test performance. Both seeders ensure permissions and search indexes are rebuilt after creation.

database/seeders · high confidence

New entity management tools for cloning, hierarchy transformation, and content rendering

This change introduces a suite of new tool classes in app/Entities/Tools to handle complex entity operations. The Cloner tool enables users to clone books, chapters, and pages, including copying permissions, tags, and cover images. HierarchyTransformer allows converting chapters to books and books to shelves. BookContents and NextPreviousContentLocator manage book structure and navigation. PageContent and its associated parsers (PageIncludeParser, PageIncludeContent) handle page rendering, including support for nested includes and base64 image extraction. EntityCover, EntityDefaultTemplate, and EntityHtmlDescription manage entity metadata. MixedEntityListLoader and EntityHydrator optimize loading of mixed entity types. PageEditActivity and PageEditorData support draft editing and conflict warnings.

app/Entities/Tools · high confidence

New entity view components and notification watch controls

This change introduces a comprehensive set of new Blade view templates for the entities section, standardizing the presentation of entity lists, grid items, breadcrumbs, and tag management. It also adds the user interface for the new notification watch system, including watch controls and action buttons that allow users to subscribe to updates for specific entities.

resources/views/entities · high confidence

New extensible theme system with modules and event hooks

BookStack introduces a new theme system that allows users to extend the application beyond simple visual styling. Users can now install theme modules (via ZIP files) to add custom functionality, such as injecting custom HTML into the page head or registering new Artisan commands. The system provides a robust event hook framework (documented in ThemeEvents) enabling themes to intercept and modify core behaviors, including authentication flows (OIDC pre-redirect, pre-register), page content rendering, and route registration. Additionally, themes can now serve public static files and inject custom views before or after existing application views, offering granular control over the user interface and application logic.

app/Theming · high confidence

New form definitions for editor objects, tables, and utilities

The WYSIWYG editor now includes default form definitions for managing images, links, media, and table structures. Users can edit image properties (source, alt text, dimensions) and link attributes (URL, display text, target window) via dedicated modals. Table editing capabilities have been expanded with forms for cell properties (width, height, alignment, borders, background color) and row properties (height, borders, background color). Additionally, a 'Source' form allows direct HTML editing, and an 'About' form provides access to help documentation.

resources/js/wysiwyg/ui/defaults/forms · high confidence

New form input components and entity permission interface

This change introduces a suite of new reusable form components in the \resources/views/form\ directory, including \checkbox\, \custom-checkbox\, \date\, \number\, \password\, \text\, \textarea\, \toggle-switch\, \image-picker\, \page-picker\, \user-select\, \role-select\, \role-checkboxes\, \simple-dropzone\, and \description-html-input\. These components standardize form rendering with consistent error handling, accessibility attributes (such as \aria-label\ and \role\), and support for features like autofocus and disabled states. Additionally, it adds a new entity permissions management interface (\entity-permissions\ and \entity-permissions-row\) that allows users to configure view, create, update, and delete permissions for specific roles, including an 'Everyone Else' default role with inheritance options. The legacy \delete-button\ component has been removed.

resources/views/form · high confidence

New help pages for WYSIWYG editor shortcuts and licensing

Added dedicated help views for the WYSIWYG editor, including a shortcuts reference page (wysiwyg.blade.php) that documents keyboard shortcuts for actions like saving, formatting, and inserting lists, as well as a licensing page (licenses.blade.php) that displays the MIT license for the underlying Lexical editor and other third-party dependencies. A separate TinyMCE help page (tinymce.blade.php) is also included for legacy editor documentation.

resources/views/help · high confidence

New layout editor interface for customizing page structures

Users can now access a dedicated layout editing interface under Settings to customize the arrangement of page blocks. This new view introduces a drag-and-drop style editor with distinct columns for left, center, and right block placement, as well as an unused area for available components. The interface allows users to reorder blocks using move actions, add new blocks, or remove existing ones via a dropdown menu. A 'Reset to Defaults' button is provided to restore the original layout configuration, and the editor supports navigation between different layout locations (e.g., book, page) via a sidebar.

resources/views/settings/layouts · high confidence

New layout partials and theme system hooks

This update introduces a set of new convenience partials in the layout system to support visual theming and improve user experience. Theme users can now inject custom HTML into the document head via the new \custom-head.blade.php\ partial, and apply site-wide color settings through \custom-styles.blade.php\, which maps application settings to CSS variables for both light and dark modes. The layout also includes new placeholder partials (\base-body-start\, \base-body-end\, \export-body-start\, \export-body-end\, \header-links-start\) to allow easier customization of page structure. Additionally, a new \back-to-top.blade.php\ component provides a scroll progress indicator and button, while \skip-to-content.blade.php\ adds an accessibility shortcut for keyboard users.

resources/views/layouts/parts · high confidence

This change introduces a new set of model resolvers in the References module to handle the resolution of various link types to their corresponding models. Specifically, it adds resolvers for attachments, books, bookshelves, chapters, images, pages, and page permalinks. Each resolver implements the CrossLinkModelResolver interface and uses specific patterns to identify and resolve the linked entity. This enhancement improves the system's ability to accurately resolve and manage cross-links within the application.

app/References/ModelResolvers · high confidence

New notification handler framework for page and comment activity

A new notification handler system has been introduced in the activity layer to manage user notifications for page and comment events. This includes specific handlers for page creation, page updates, comment creation, and comment mentions. The system enforces permission checks to ensure users only receive notifications for content they can view and have permission to receive notifications for. It also respects individual user notification preferences, such as ignoring notifications for own page comments or changes, and prevents duplicate notifications for comment mentions during edits by tracking previously notified users.

app/Activity/Notifications/Handlers · high confidence

New page management views for copy, delete, move, and permissions

Added dedicated Blade templates for page lifecycle actions: copy, delete, move, and permissions. The copy view allows users to select a destination book or chapter and provides copy-specific considerations. The delete view warns users if the page is used as a template. The move view enables relocating pages to other books or chapters. The permissions view manages access controls. Additionally, new views were added for viewing page revisions (list and individual revision details) and inbound references, alongside updates to the page edit and show views to support these features.

resources/views/pages · high confidence

New permissions management API and evaluation engine

The application introduces a new permissions subsystem that adds a dedicated Content Permission API (ContentPermissionApiController) for reading and updating content-level permission overrides via JSON, and a new EntityPermissionEvaluator class that calculates access by traversing the entity hierarchy (page, chapter, book) to resolve role and fallback permissions. This change also includes a JointPermissionBuilder for pre-computing cached view permissions across all entities and roles to improve query performance, alongside updated controllers (PermissionsController) and form data handling (PermissionFormData) to support the new permission structure.

app/Permissions · high confidence

This change introduces a dedicated reference management system within the application. It adds a new \CrossLinkParser\ to extract linked models from HTML content, a \ReferenceStore\ to persist and update outgoing references for entities, and a \ReferenceFetcher\ to query incoming references with permission checks. A new \ReferenceController\ exposes views for pages, chapters, books, and shelves to display their incoming references. Additionally, a \ReferenceUpdater\ handles the logic for updating links within entity content (HTML and Markdown) and descriptions when entities are moved or renamed, ensuring that internal links remain valid.

app/References · high confidence

New role management interface with CRUD and user assignment

The settings area now includes a complete interface for managing user roles, featuring an index page with search, sorting, and pagination, as well as views for creating, editing, and deleting roles. The edit view allows administrators to assign existing users to a role and includes a 'copy' action to duplicate role configurations. The delete view provides a safety mechanism by prompting for a replacement role if users are currently assigned to the role being deleted.

resources/views/settings/roles · high confidence

New security and content utility classes for CSP, HTML filtering, and SSR validation

The app/Util directory now includes a suite of new utility classes that enhance security and content handling. CspService and HtmlNonceApplicator manage Content Security Policy headers and script/style nonces, while HtmlContentFilter and HtmlDescriptionFilter provide configurable, strict filtering of HTML content to remove scripts, forms, and dangerous attributes. SsrUrlValidator and UrlFilter enforce allow-lists for server-side requests and link schemes, and WebSafeMimeSniffer ensures served files have safe MIME types. Additional utilities like DateFormatter, DatabaseTransaction, and SimpleListOptions standardize date handling, database isolation, and list sorting.

app/Util · high confidence

New settings management architecture and customization options

The application introduces a new settings subsystem that restructures how configuration is stored and managed. Administrators can now customize the application's visual identity by uploading a custom app logo and icon (favicon), with the system automatically generating required image sizes and handling cleanup. A dedicated maintenance page allows admins to clean up unused images, regenerate the reference index, and send test emails. The settings system also supports granular user notification preferences (for page changes, comments, and mentions) and configurable keyboard shortcuts, all backed by a new service layer that handles local caching and user-specific storage.

app/Settings · high confidence

New settings pages for customization, features, registration, and sorting

Added four new settings view files (customization, features, registration, sorting) under resources/views/settings/categories. These pages provide UI controls for app branding and editor selection, public access and security toggles, user registration options, and list/page limits with default book sorting rules. The sorting page also lists existing sort rules and links to create new ones.

resources/views/settings/categories · high confidence

New shelf management views and social meta tags

The application now includes dedicated Blade templates for creating, editing, deleting, and managing permissions for bookshelves, providing a consistent UI with breadcrumbs and form handling. The main shelf view supports both grid and list layouts for books, includes sorting controls, and displays an empty state with actions to add books or edit the shelf. Additionally, Open Graph meta tags for descriptions and cover images are now generated for shelf pages to improve social sharing previews.

resources/views/shelves · high confidence

New structured email notification messages for activity events

This change introduces a new set of PHP classes in the \app/Activity/Notifications\ directory that define how activity notifications (such as page creation, page updates, comment creation, and comment mentions) are formatted into emails. It adds specific notification message classes (\PageCreationNotification\, \PageUpdateNotification\, \CommentCreationNotification\, \CommentMentionNotification\) that construct localized mail content using new helper classes (\EntityLinkMessageLine\, \EntityPathMessageLine\, \ListMessageLine\, \LinkedMailMessageLine\) to render entity links, hierarchical paths, and structured lists. This represents a shift towards a more modular and structured approach for generating notification emails, replacing or augmenting previous ad-hoc email generation logic.

app/Activity/Notifications/Messages · high confidence

New unified search interface with advanced filtering

The application now features a redesigned search experience centered on the new \resources/views/search/all.blade.php\ view. Users can perform global searches via a prominent search box that displays results with tags and pagination. The interface includes an advanced filter panel allowing users to narrow results by content type (pages, chapters, books, bookshelves), exact matches, and tags. Additionally, authenticated users can apply personal filters such as viewing items created, updated, or owned by them, as well as restricting results to those they have already viewed.

resources/views/search · high confidence

New user and role management controllers for the application

This change introduces a new set of controllers in the Users module to handle user and role management. The \UserController\ and \UserApiController\ manage the creation, editing, and deletion of user accounts, including profile image uploads and role assignments. The \RoleController\ and \RoleApiController\ provide similar CRUD operations for system roles, allowing administrators to manage permissions and MFA enforcement settings. Additionally, the \UserAccountController\ handles self-service profile updates, interface preferences (like dark mode and language), and notification settings for logged-in users. The \UserPreferencesController\ manages user-specific UI preferences such as view types and sort orders, while \UserProfileController\ displays public user profiles with activity and content counts. Finally, \UserSearchController\ provides endpoints for searching users in select and mention contexts.

app/Users/Controllers · high confidence

New user management and profile views

This change introduces a new set of Blade templates for the user management section, including views for listing users with search and sorting, creating and editing user profiles (with avatar and language settings), deleting users with ownership migration, and managing API tokens. It also adds a public-facing user profile page that displays the user's avatar, account age, content creation counts (pages, chapters, books, shelves), and recent activity. These views replace the previous implementation, providing a consistent design and new capabilities like API token management and detailed user profiles.

resources/views/users · high confidence

New webhook management interface with configuration and examples

The webhook settings page now includes a dedicated management interface allowing users to create and edit webhooks. The new form enables configuring the webhook's active status, name, endpoint URL, and timeout value, as well as selecting specific activity events to trigger the webhook. A list view displays existing webhooks with their active status and triggered events, while a format example section provides a sample JSON payload to help users understand the data structure sent to their endpoints.

resources/views/settings/webhooks/parts · high confidence

OpenSearch XML generation and robots.txt dynamic control

The application now provides a dynamic OpenSearch description endpoint (opensearch.blade.php) that generates valid XML with a short name limited to 16 characters, a translatable description, and multiple image sizes for search integration. Additionally, the robots.txt file has been moved to a Blade view to allow dynamic control over search engine crawling based on an $allowRobots variable, enabling administrators to toggle whether robots are allowed to access the site.

resources/views/misc · high confidence

The attachment management interface has been rebuilt to support drag-and-drop file uploads, direct link attachments, and reordering. Users can now upload multiple files via a dropzone, insert external links through a dedicated form, and reorder items using a sortable list. The manager also includes an edit form for updating file names or switching between file and link types, along with permission-based controls for editing and deleting attachments.

resources/views/attachments · high confidence

TinyMCE editor receives extensive plugin and behavior enhancements

The WYSIWYG editor now includes several new capabilities and improved existing behaviors. Users can insert and edit code blocks with syntax highlighting via the new code editor plugin, and create diagrams using the integrated Draw.io plugin. Collapsible content blocks (details/summary) are now supported with a dedicated UI for editing toggle labels. Task lists are introduced as a distinct list type, separate from standard bullet lists. Table handling has been enhanced with context toolbars, commands to clear formatting and resize to contents, and fixes for alignment and text direction in complex selections. Additionally, the editor now supports pasting images directly from the clipboard, inserting horizontal rules, and accessing an 'About' help dialog.

resources/js/wysiwyg-tinymce · high confidence

Removals

Removed default English language files for pagination and password reset

The default English language files for pagination (resources/lang/en/pagination.php) and password reset (resources/lang/en/passwords.php) have been deleted. This removes the built-in English translations for pagination links and password broker messages, likely because the application now relies on a different localization strategy or these defaults are no longer needed.

resources/lang · high confidence

Removed legacy BookRepo class

The legacy BookRepo class in the app/Repos directory has been removed. This deletion eliminates the previous abstraction layer for book data access, indicating a consolidation or refactoring of how book entities are retrieved and managed within the application.

app/Repos · high confidence

Removed legacy CSS styles and source maps

The \public/css/app.css\ file and its associated source map (\app.css.map\) have been deleted. This removes the previously bundled CSS styles, including the Meyer reset, typography, grid, button, and form styles, from the public assets.

public/css · high confidence

Removed legacy Laravel 5.2 authentication controllers

The \AuthController\ and \PasswordController\ classes, which previously handled user registration, login, and password resets using Laravel 5.2 traits, have been removed from the application. This deletion indicates that the standard form-based authentication and password reset flows provided by these controllers are no longer part of the codebase, likely having been replaced by alternative authentication mechanisms such as the LDAP or social integration features mentioned in the commit history.

app/Http/Controllers/Auth · high confidence

Removed legacy Laravel service providers

The application has removed the AppServiceProvider, EventServiceProvider, and RouteServiceProvider files. These files, which previously defined empty service registrations, event listener mappings, and route groupings under the 'Oxbow' namespace, are no longer present in the codebase.

app/Providers · high confidence

Removed legacy Oxbow base layout and added views documentation

The legacy \base.blade.php\ layout, which served as the root template for the previous 'Oxbow' application version, has been removed. This file previously defined the global HTML structure, including the header, menu, and footer for the old UI. In its place, a \readme.md\ file has been added to document the current Blade view conventions and the visual theme system for overriding views.

resources/views · high confidence

Removed legacy Oxbow controller scaffolding

The legacy \BookController\, \PageController\, and base \Controller\ classes from the \Oxbow\ namespace have been removed from the application. This cleanup eliminates unused routing endpoints and base classes that are no longer part of the current codebase structure.

app/Http/Controllers · high confidence

Removed legacy Oxbow namespace models and base classes

The application has removed the legacy \Book\, \User\, and \Job\ model classes that were previously defined under the \Oxbow\ namespace. These files, which contained basic Eloquent model definitions and queueable job base logic, have been deleted from the \app\ directory, indicating a cleanup or migration away from the initial \Oxbow\ codebase structure.

app · high confidence

Removed legacy SCSS component library

The legacy SCSS component library has been removed from the project. This includes the deletion of core styling files for layout and UI elements: \\_blocks.scss\ (background shading, borders, padding, margins), \\_buttons.scss\ (button styles and groups), \\_forms.scss\ (input and label styles), \\_grid.scss\ (column and container grid system), \\_html.scss\ (base HTML resets), \\_mixins.scss\ (responsive and utility mixins), \\_text.scss\ (typography and text utilities), and \\_variables.scss\ (global design tokens like colors, spacing, and breakpoints). The main entry point \styles.scss\ has also been removed, indicating a shift away from this specific CSS architecture.

resources/assets · high confidence

Security

Prevent directory listing in public uploads

Added .htaccess and .gitignore files to the public/uploads directory to disable Apache directory indexing (Options -Indexes) and ensure the folder remains ignored by version control except for these configuration files, preventing accidental exposure of uploaded file contents.

public/uploads · high confidence

Architecture

Major internal refactoring of data models and application structure

The application's internal architecture has been significantly restructured to improve maintainability and performance. Core entity models (Book, Page, Chapter, Bookshelf) have been refactored to use a unified single-table inheritance pattern via a shared \entities\ table and separate data tables (\EntityPageData\, \EntityContainerData\), replacing the previous multi-table structure. New models have been introduced to support enhanced features, including \MfaValue\ for multi-factor authentication, \ApiToken\ for API access management, \Watch\ and \Favourite\ for user engagement tracking, and \Import\ for ZIP-based data imports. The permission system has been updated with new models like \JointPermission\ and \RolePermission\, and the codebase has been reorganized into a feature-based structure with new tools for page editing (\PageEditorType\) and entity management.

bookstackapp/bookstack · high confidence

Refactored HTTP layer to support modern Laravel architecture and range-based streaming

The application's HTTP layer has been restructured to align with modern Laravel standards, moving from the legacy 'Oxbow' namespace to 'BookStack' and replacing the old route file with a middleware-group-based Kernel configuration. This change introduces a new \ApiController\ base class to standardize JSON listing responses and validation, and adds a \DownloadResponseFactory\ that enables HTTP range requests for efficient, resumable file downloads. Additionally, a custom \Request\ class ensures the application correctly respects the configured \APP\_URL\ for scheme and base path resolution.

app/Http · high confidence

Refactored entity repositories into a shared base class with specialized implementations

The entity repository logic has been restructured to improve code reuse and consistency. A new \BaseRepo\ class now handles common operations for all entities, including creation, updates, cover image management, slug generation, description handling, and reference updates. Specific repositories (\BookRepo\, \BookshelfRepo\, \ChapterRepo\, \PageRepo\, \RevisionRepo\, and \DeletionRepo\) now extend or utilize this base class, delegating shared responsibilities while implementing entity-specific behaviors like trash can integration, activity logging, and parent sorting. This change centralizes core entity management logic, reducing duplication across book, shelf, chapter, and page operations.

app/Entities/Repos · high confidence

Behavioural changes

13 commits (1 fix) modifying (repo-wide)

A change to existing behaviour in (repo-wide) — 13 commits (1 fix), 8 files: “TinyMCE: Updated version from 6.8.3 to 6.8.4”; “Added libs into project and fixed ol lists”; “Updated tinymce to v4.8.3”; and 10 more.

(repo-wide) · medium confidence · unverified

A change to existing behaviour in public/libs/tinymce/plugins/autolink, public/libs/tinymce/plugins/nonbreaking — 14 commits (1 fix), 2 files: “Upgrade tinymce version”; “TinyMCE: Updated version from 6.8.3 to 6.8.4”; “Added libs into project and fixed ol lists”; and 11 more.

public/libs/tinymce/plugins/autolink, public/libs/tinymce/plugins/nonbreaking · medium confidence · unverified

14 commits (1 fix) modifying public/libs/tinymce/plugins/importcss, public/libs/tinymce/plugins/media

A change to existing behaviour in public/libs/tinymce/plugins/importcss, public/libs/tinymce/plugins/media — 14 commits (1 fix), 2 files: “TinyMCE: Updated version from 6.8.3 to 6.8.4”; “Added libs into project and fixed ol lists”; “Updated tinymce to v4.8.3”; and 11 more.

public/libs/tinymce/plugins/importcss, public/libs/tinymce/plugins/media · medium confidence · unverified

15 commits (1 fix) modifying public/libs/tinymce/plugins/codesample, public/libs/tinymce/plugins/fullscreen

A change to existing behaviour in public/libs/tinymce/plugins/codesample, public/libs/tinymce/plugins/fullscreen — 15 commits (1 fix), 2 files: “TinyMCE: Updated version from 6.8.3 to 6.8.4”; “Added libs into project and fixed ol lists”; “Updated tinymce to v4.8.3”; and 12 more.

public/libs/tinymce/plugins/codesample, public/libs/tinymce/plugins/fullscreen · medium confidence · unverified

API documentation views restructured with new endpoint detail components

The API documentation interface has been updated to use new Blade view components for rendering endpoint information. The \endpoint-details.blade.php\ component now supports multi-paragraph descriptions and displays body/query parameters in a collapsible table, along with collapsible sections for example requests and responses. The \endpoint.blade.php\ component provides a consistent layout for listing endpoints, including method badges and links to the actual API paths. Additionally, the \getting-started.blade.php\ component has been expanded to include detailed sections on authentication, request formats (including workarounds for PUT/DELETE with form data), and listing parameters.

resources/views/api-docs/parts · high confidence

API tokens list and creation form redesigned for responsiveness

The API tokens management interface has been updated to a new responsive layout. The list view now displays token names, IDs, and expiration dates in a structured row format with action buttons, while the creation form uses a grid-based layout for the token name and expiry date inputs.

resources/views/users/api-tokens/parts · high confidence

Added checksum verification for CLI vendor dependencies

A new \.gitignore\ file and a \vendor\ checksum file have been added to the \dev/checksums\ directory. The \vendor\ file contains a SHA-256 hash (\22e02ee...\) used to verify the integrity of the System CLI's vendor dependencies, ensuring that the bundled code matches the expected version.

dev/checksums · high confidence

Application namespace and bootstrap structure updated

The application's internal namespace has been changed from 'Oxbow' to 'BookStack', updating the core application class and key service providers (HTTP Kernel, Console Kernel, and Exception Handler) to use the new namespace. Additionally, the legacy bootstrap/autoload.php file has been removed, and a new bootstrap/phpstan.php configuration file has been added to override filesystem settings for static analysis tools.

bootstrap · high confidence

Build system migrated to esbuild with custom livereload

The development build process has been replaced with an esbuild-based setup. This introduces a new build script (esbuild.mjs) that bundles JavaScript and TypeScript entry points into the public/dist directory, supports production minification, and generates metafiles for analysis. For local development, a custom livereload mechanism (livereload.js) is now used to inject into the browser via an EventSource, enabling automatic page reloads or CSS hot-reloading on file changes. Additionally, a stub transformer for SVG files has been added to support Jest testing.

dev/build · high confidence

Centralized entity query classes for books, pages, and shelves

The app/Entities/Queries directory now contains dedicated query classes (BookQueries, PageQueries, ChapterQueries, BookshelfQueries, and EntityQueries) that centralize how entities are fetched. These classes enforce visibility rules via scopes, provide consistent list and content retrieval methods, and support lookups by ID or slug (including old slugs via history). A unified EntityQueries class routes lookups by type and exposes a combined visible-for-list query across all entity types, while separate classes handle popular, recently viewed, and top favourites lists. This refactoring standardizes data access and improves consistency for users browsing, searching, and viewing entity lists.

app/Entities/Queries · high confidence

Complete visual redesign and dark mode support

The application's styling has been completely rewritten using modern SCSS modules, introducing a comprehensive dark mode theme alongside the existing light mode. This overhaul standardizes the visual language across all interface components, including the header, sidebar, page editor, and content blocks, while also improving responsive layouts and accessibility features like focus states and RTL support.

resources/sass · high confidence

Configuration files migrated to app/Config directory

The application's configuration files (including api, app, auth, cache, clockwork, database, exports, filesystems, hashing, logging, mail, oidc, queue, and saml2) have been moved into the app/Config directory. This change reorganizes the project structure to align with the new Laravel framework version, ensuring that configuration options are loaded from this specific location.

app/Config · high confidence

Custom pagination view with theme-aware active state

A new default pagination view has been added for the vendor pagination component. This view renders standard pagination links and applies the 'primary-background' CSS class to the currently active page, allowing the active state to align with the application's theme colors.

resources/views/vendor/pagination · high confidence

Enhanced HTML content filtering and security

The HTML purifier now enforces stricter security rules by limiting the file:// protocol to anchor links only, preventing potential network requests via images or iframes. It also adds support for SFTP URIs, allows table cell alignment attributes, and properly handles srcset attributes and fragment-based anchors. Additionally, the purifier now preserves checkbox inputs and allows target="\_blank" on links.

app/Util/HtmlPurifier · high confidence

Enhanced translation loading and locale management

The translation system now supports overriding strings via the theme system and modules by extending the file loader to merge translations from theme and module directories. Locale handling has been refactored into dedicated classes, including a LocaleManager that maps internal locale names to ISO standards and a LocaleDefinition class for HTML attributes. Pluralization logic has been updated to correctly handle non-standard locale identifiers like 'de\_informal' by stripping suffixes before determining plural rules.

app/Translation · high confidence

Frontend services converted to TypeScript

The JavaScript services in resources/js/services have been converted to TypeScript, including the HTTP client, event manager, DOM utilities, keyboard navigation, animations, clipboard handling, component store, translations, and virtual DOM patching. A new test suite has been added for the translations service to verify pluralization and replacement logic.

resources/js/services · high confidence

Homepage layout and content sections refactored into modular Blade views

The homepage rendering logic has been restructured to support distinct layout modes (default, books, shelves, and specific page) via new dedicated view files. The default layout now uses a three-column grid for content blocks, while non-default layouts utilize a two-column sidebar structure. All homepage content sections—such as recent activity, drafts, updated pages, and favorites—are now extracted into separate, reusable partials, with specific variants provided for the default card-style layout versus the non-default list-style layout. Additionally, a new expand-toggle component allows users to persistently control the visibility of detailed content within these sections.

resources/views/home · high confidence

Improved HTML-to-Markdown conversion and Markdown rendering consistency

The Markdown conversion tools have been updated to better handle specific HTML elements and improve rendering consistency. HTML-to-Markdown conversion now supports checkboxes (rendering as task lists), preserves draw.io diagram blocks, and correctly handles iframe and summary tags. On the rendering side, Markdown strikethrough now uses \<s\> tags to match the front-end, and task list items are explicitly styled. These changes ensure that content exported to Markdown and rendered back to HTML maintains its structure and visual intent more accurately.

app/Entities/Tools/Markdown · high confidence

Introduced Lexical-based WYSIWYG editor UI framework

The WYSIWYG editor UI has been rebuilt using the Lexical framework, introducing a new \buildEditorUI\ entry point that initializes the editor container, manages DOM structure (including scroll and content areas), and handles configuration options such as text direction and dark mode. This change replaces the previous editor implementation with a new architecture centered around an \EditorUIManager\ and \EditorUiContext\, providing foundational support for toolbar management, translations, and error handling within the editor interface.

resources/js/wysiwyg/ui · high confidence

Introduces shared entity model interfaces and traits

The entity model layer now includes a set of new interfaces (DeletableInterface, HasCoverInterface, HasDefaultTemplateInterface, HasDescriptionInterface) and a ContainerTrait to standardize how entity models handle specific capabilities like deletion tracking, cover images, default templates, and descriptions. Additionally, an EntityScope and EntityQueryBuilder are introduced to enforce consistent query scoping based on entity type, ensuring that queries automatically filter by the correct morph class and join relevant data tables.

app/Entities/Models · high confidence

Markdown editor rewritten in TypeScript with CodeMirror and plaintext mode

The Markdown editor in the Page Editor has been completely rewritten in TypeScript, replacing the previous implementation with a modular architecture. The editor now uses CodeMirror as the underlying input engine by default, providing a richer editing experience, but users can switch to a simple plaintext textarea mode via the 'plainEditor' setting. This change introduces new capabilities such as drag-and-drop image insertion, clipboard image pasting, and improved handling of draw.io diagrams within the editor. The editor's behavior is now driven by a new input interface, allowing for seamless switching between the CodeMirror and plaintext modes without losing state or settings.

resources/js/markdown · high confidence

Middleware layer refactored for Laravel 10 and BookStack namespace

The middleware layer has been significantly refactored to align with Laravel 10 standards and the application's new BookStack namespace. Existing middleware classes (Authenticate, EncryptCookies, RedirectIfAuthenticated, VerifyCsrfToken) have been updated to use modern PHP type declarations, Laravel 10 base classes, and the correct namespace. New middleware has been introduced to support specific features: ApiAuthenticate for API access control, ApplyCspRules for Content Security Policy headers, AuthenticatedOrPendingMfa for multi-factor authentication flows, CheckEmailConfirmed for email verification enforcement, CheckGuard for guard-specific access, CheckUserHasPermission for role-based checks, ClearPerRequestCaches for cache management, Localization for language handling, PreventResponseCaching for security, RunThemeActions for theme integration, StartSessionExtended and StartSessionIfCookieExists for session management, ThrottleApiRequests for API rate limiting, and TrustProxies for proxy configuration. Additionally, VerifyCsrfToken now excludes SAML routes from CSRF verification.

app/Http/Middleware · high confidence

Migrated core application entry point and global types to TypeScript

The main application entry point (app.ts) and global type definitions (global.d.ts, custom.d.ts) have been converted to TypeScript. This change establishes the TypeScript-based initialization sequence for global services, including HTTP, event, translation, and component management, while defining the corresponding global window interface to ensure type safety for these shared utilities across the application.

resources/js · high confidence

Modularized book views and enhanced sorting interface

The book listing and detail pages have been restructured into reusable, modular Blade components (e.g., sidebar sections, list items) to improve maintainability and consistency. The book sorting interface has been significantly upgraded with a new UI that supports manual drag-and-drop reordering, button-based movement controls (up/down/prev/next), and the ability to toggle auto-sorting rules directly within the sort box.

resources/views/books/parts · high confidence

Modularized chapter sidebar and list views

The chapter view components have been reorganized into distinct, reusable partials to improve modularity and consistency. New blade files now handle specific UI sections: \child-menu.blade.php\ renders the expandable list of child pages within a chapter, \list-item.blade.php\ displays individual chapters in lists with their page counts, and \show-sidebar-section-actions.blade.php\, \show-sidebar-section-details.blade.php\, and \show-sidebar-section-tags.blade.php\ break down the chapter detail page's sidebar into separate action, metadata, and tag blocks. Additionally, \convert-to-book.blade.php\ provides the UI for converting a chapter to a book, and \form.blade.php\ consolidates the chapter editing form including description and template selectors.

resources/views/chapters/parts · high confidence

New Docker development environment with PHP 8.5 and LDAP support

The development Docker setup has been rewritten to use the PHP 8.5 Apache base image, replacing previous versions. This new configuration installs essential system dependencies including Git, Zip/Unzip, and LDAP libraries, and enables PHP extensions for PDO MySQL, GD (with FreeType and JPEG support), LDAP, and Zip. Xdebug is now included for development. The entrypoint scripts automate the setup process: the application entrypoint runs Composer install, waits for the database, executes migrations, and fixes file permissions before starting Apache, while the Node entrypoint handles npm dependencies and starts the asset watcher. Git is configured to treat the /app directory as safe to handle ownership checks in Docker containers.

dev/docker · high confidence

New MFA implementation with backup codes, TOTP, and rate limiting

The MFA system has been restructured into dedicated service classes within app/Access/Mfa. Users can now use backup codes (generated in sets of 16) and TOTP (with QR code generation) for two-factor authentication. A new MfaSession class manages verification state, while MfaVerificationLimiter enforces rate limits on verification attempts (5 per user per minute, 60 per IP per minute) to prevent brute-force attacks.

app/Access/Mfa · high confidence

New WYSIWYG UI framework for Lexical editor components

The WYSIWYG editor now uses a new internal UI framework to manage its interface elements. This introduces structured classes for toolbar buttons, context toolbars, modals, and form fields, along with a central manager to coordinate state updates and event handling. For users, this provides a more consistent and stable editing experience, including improved focus management (returning focus to the editor on Escape), smarter context toolbar positioning to prevent overlaps, and reliable modal behavior.

resources/js/wysiwyg/ui/framework · high confidence

New activity tracking interfaces and webhook listing query

The application introduces three new interfaces—Favouritable, Loggable, and Viewable—within the Activity models to standardize how entities expose their activity-related data (such as favourites, logs, and views). Additionally, a new query class, WebhooksAllPaginatedAndSorted, has been added to support paginated, sorted, and searchable retrieval of all webhooks in the system.

app/Activity/Models, app/Activity/Queries · high confidence

New modular search filter and list components

The search interface now uses a set of new, reusable Blade view components located in \resources/views/search/parts\ to render specific UI elements. These include \boolean-filter.blade.php\ and \type-filter.blade.php\ for checkbox-based filtering, \date-filter.blade.php\ for optional date inputs, \term-list.blade.php\ for managing exact or tag-based search terms with add/remove functionality, and \entity-selector-list.blade.php\ and \entity-suggestion-list.blade.php\ for displaying lists of entities or suggestions. This change restructures the search UI into distinct, manageable parts rather than monolithic views.

resources/views/search/parts · high confidence

Re-enabled plaintext email notifications and updated HTML templates

Users will now receive email notifications in plaintext format again, as the dedicated \email-plain.blade.php\ view has been restored. The HTML email template (\email.blade.php\) has also been updated to include the application logo in the header and footer, and to support locale-specific text direction and language attributes for better internationalization.

resources/views/vendor/notifications · high confidence

Recycle bin list items now display hierarchical content counts and parent context

The recycle bin interface has been updated to provide more context for deleted items. List entries now explicitly show the number of chapters and pages contained within deleted books or chapters, helping users understand the scope of what is being restored or permanently deleted. Additionally, the view now displays the name of the parent entity (e.g., the book a chapter belonged to) and the user who performed the deletion, improving traceability. The layout has also been restructured into a responsive row-based format with clear action buttons for restoring or permanently deleting items.

resources/views/settings/recycle-bin/parts · high confidence

Redesigned authentication and registration views with social login support

The authentication interface has been updated with a new design, introducing dedicated views for login, registration, and email confirmation flows. Users can now sign up or log in using social accounts (such as Facebook, Slack, and Twitter) via new social driver buttons on the login and register pages. The registration form includes a honeypot field to help prevent bot submissions, and the email confirmation process has been refined with specific pages for awaiting confirmation and accepting the confirmation link. Additionally, a new view allows invited users to set their password directly.

resources/views/auth · high confidence

Redesigned book management interface with tri-column layout and new actions

The book views have been significantly updated to use a new tri-column layout (layouts.tri) and a simplified single-column layout for specific actions. The main index and show pages now feature modular sidebars for blocks and breadcrumbs, replacing the previous basic content sections. New dedicated views have been added for copying, deleting, managing permissions, viewing references, and sorting books, providing users with clearer, focused interfaces for these tasks. The create and edit forms have been modernized with improved breadcrumb navigation and structured form components, enhancing the overall user experience for book management.

resources/views/books · high confidence

Redesigned error pages with consistent layout and improved content

The error views (404, 500, 503, and debug) have been completely rewritten to use the application's standard layout system (e.g., \layouts.simple\, \layouts.base\, \layouts.plain\) instead of standalone HTML. The 404 page now includes a login link for guests and displays popular pages, books, and chapters when appropriate. The 503 page has been simplified to use the new card-based design. A new custom debug view (\debug.blade.php\) provides structured error details, environment info, and helpful links for administrators. The 500 error page now uses a consistent card layout. These changes improve visual consistency and user experience across all error states.

resources/views/errors · high confidence

Redesigned password reset and email views with simplified layout

The password reset flow now uses a new, simplified layout (\layouts.simple\) for both the email request and reset forms. The UI has been updated to use a card-based design with specific styling classes, and all user-facing text has been extracted into language files using the \trans()\ helper for better maintainability. The form actions now explicitly target the standard Laravel password reset routes (\/password/email\ and \/password/reset\).

resources/views/auth/passwords · high confidence

Redesigned recycle bin interface with parent deletion context

The recycle bin settings view has been restructured into dedicated pages for listing, restoring, and permanently deleting items. The main list view now displays the parent entity for each deleted item, providing better context. The restore and destroy actions now explicitly show if a parent entity is also in the trash and offer a direct link to restore the parent, ensuring users are aware of and can manage hierarchical dependencies when recovering or permanently removing content.

resources/views/settings/recycle-bin · high confidence

Redesigned role permissions interface with granular asset controls

The role management settings have been restructured to offer a more detailed and accessible permissions configuration. The form now includes specific system-level permissions for content import/export, editor changes, and notifications, alongside standard user and settings management. Asset permissions are organized into a responsive table that allows administrators to independently toggle create, view, edit, and delete rights for shelves, books, chapters, pages, revisions, images, attachments, and comments. This update also introduces 'own' vs 'all' permission distinctions for pages and books, adds accessibility labels for screen readers, and displays user/permission counts in the role list.

resources/views/settings/roles/parts · high confidence

Redesigned shelf management interface with drag-and-drop sorting and modular views

The shelf creation and editing forms now include a new drag-and-drop interface for reordering books within a shelf, allowing users to easily manage the sequence of content. The shelf list and detail pages have been restructured into modular sidebar sections (actions, details, activity, tags) and a unified list view that displays shelf covers, excerpts, and associated books. Additionally, the description field now supports rich text editing via a WYSIWYG editor, enhancing the ability to format shelf content.

resources/views/shelves/parts · high confidence

Redesigned tags list view with responsive layout and usage statistics

The tags index page has been updated to a new responsive design. Users will now see a list of tags that includes specific usage statistics for pages, chapters, books, and bookshelves, displayed as clickable links. The view also supports filtering by tag name and includes a search input to help locate specific tags within the library.

resources/views/tags · high confidence

Refactored MFA verification UI into reusable partials with autofill support

The MFA verification interface has been restructured into dedicated Blade partials (setup-method-row, verify-totp, verify-backup\_codes) to standardize the layout and styling. This change introduces browser autofill support for TOTP and backup code inputs via the 'one-time-code' autocomplete attribute, while ensuring the form itself disables general autocomplete. Users will experience a more consistent visual style across MFA setup and verification steps, along with faster code entry through native browser autofill capabilities.

resources/views/mfa/parts · high confidence

Refactored application service providers for Laravel 10/11 compatibility

The application's service provider structure has been reorganized into distinct, single-responsibility classes (AppServiceProvider, AuthServiceProvider, EventServiceProvider, RouteServiceProvider, ThemeServiceProvider, TranslationServiceProvider, ValidationRuleServiceProvider, and ViewTweaksServiceProvider) to align with modern Laravel standards. This refactoring centralizes configuration for custom authentication guards (API token, LDAP, async external), enforces stricter URL filtering via a new 'safe\_url' validation rule, implements rate limiting for API and export endpoints, and establishes a dynamic theme system that supports inserting views before or after existing includes to prevent caching conflicts.

app/App/Providers · high confidence

Refactored authentication controllers and added login attempt rate limiting

The authentication logic in the Access module has been reorganized into dedicated controllers for specific flows (Login, Registration, OIDC, SAML2, Social, MFA, Password Reset, and Email Confirmation), replacing the previous monolithic structure. This change introduces rate limiting on login attempts to prevent brute-force attacks, adds a honeypot field to the registration form to block bots, and implements a random delay in the password reset email response to mitigate timing-based enumeration attacks.

app/Access/Controllers · high confidence

Refactored exception handling with dedicated classes and API error standardization

The application's exception handling has been restructured to provide clearer error reporting for both web and API users. A new set of specific exception classes (such as ApiAuthException, NotifyException, and PrettyException) has been introduced to replace generic error throwing, allowing for more granular control over user-facing messages. For API consumers, errors are now standardized into a consistent JSON format that includes an error code and message, with sensitive debug details hidden in non-debug environments. Web users benefit from improved handling of specific scenarios, including out-of-memory events, HTTP 413 (post too large) limits, and authentication flows like email confirmation and MFA verification, which now redirect appropriately rather than showing raw errors.

app/Exceptions · high confidence

Refactored user and role management queries into dedicated classes

The logic for listing and sorting users and roles has been moved into new dedicated query classes (RolesAllPaginatedAndSorted, UsersAllPaginatedAndSorted). This change fixes a bug where sorting by 'created\_at' failed because the column name was not properly qualified with the table prefix (e.g., 'roles.created\_at'). Additionally, new query classes (UserContentCounts, UserRecentlyCreatedContent) have been introduced to handle fetching user content statistics and recent activity, centralizing these data retrieval operations.

app/Users/Queries · high confidence

Refactored user management UI into reusable partial templates

The user management interface has been restructured to improve maintainability and consistency by extracting UI components into dedicated Blade partials. The user list view now uses a new \users-list-item\ template that displays user avatars, names, emails, roles, and MFA status. The user creation and editing forms have been consolidated into a \form\ partial, which standardizes the layout for user details, role selection, and password fields based on the authentication method. Additionally, a new \language-option-row\ partial has been introduced to handle the preferred language selection dropdown, ensuring a consistent presentation for this setting across the application.

resources/views/users/parts · high confidence

Removal of empty vendor views placeholder

The empty .gitkeep file in the resources/views/vendor directory has been removed, indicating that the project no longer maintains a placeholder for vendor-specific view overrides in this location.

resources/views/vendor · high confidence

Removed legacy Laravel 4 configuration files

The application has removed its legacy Laravel 4 configuration files (app, auth, broadcasting, cache, compile, database, filesystems, mail, queue, services, session, and view). This cleanup eliminates outdated framework defaults and service provider registrations, aligning the configuration structure with the current application version and removing obsolete boilerplate that is no longer used.

config · high confidence

Removed legacy Laravel 5 model factory definitions

The legacy \database/factories/ModelFactory.php\ file, which defined the \Oxbow\\User\ model factory using the deprecated \$factory-\>define\ syntax, has been removed. This cleanup aligns with the project's migration to newer Laravel standards (Laravel 6/8), where model factories are typically defined as dedicated classes rather than a single global factory file. The empty \database/seeds/.gitkeep\ file was also removed as part of this structural cleanup.

database/factories · high confidence

Renamed sort sets to sort rules in settings

The settings interface for managing sorting configurations has been renamed from 'sort sets' to 'sort rules'. This change updates the user-facing terminology in the settings views, including the create, edit, and list pages for these configurations, as well as the database factory used to generate test data for the new 'SortRule' model.

database/factories/Sorting, resources/views/settings/sort-rules · high confidence

Reorganized export templates and added import display views

The export and import UI components in resources/views/exports/parts have been restructured. New partials (book-contents-menu, chapter-contents-menu, chapter-item, page-item, meta) now handle the rendering of book structures, chapter/page content, and metadata for exports, including support for custom HTML head content. Additionally, new import-related views (import, import-item) provide a listing and detailed display for ZIP imports, showing item names, attachment/image/tag counts, and relative timestamps.

resources/views/exports/parts · high confidence

Reorganized page editor and sidebar into modular view components

The page editing interface and display sidebars have been refactored into a set of reusable Blade partials to improve modularity and maintainability. The editor form is now constructed from \editor-toolbar\, \editor-toolbox\, and \form\ components, which handle draft management, changelog entry, and the integration of various editors (Markdown, WYSIWYG, and Lexical). The image manager has been split into distinct list and form views to support a tabbed interface with search and filtering capabilities. Additionally, the page display sidebar is now composed of specific sections for navigation, tags, attachments, and actions, and a new dedicated view for the code editor popup has been added.

resources/views/pages/parts · high confidence

Replaced legacy upload logic with dedicated service classes for images and attachments

The \app/Uploads\ directory has been restructured to use new, dedicated service classes (\AttachmentService\, \ImageService\, \ImageResizer\, \ImageStorage\, \FileStorage\, \FaviconHandler\, \UserAvatars\) that replace the previous monolithic upload handling. This change introduces a more modular approach to file management, including support for streaming attachments, resizing images via the Intervention Image library, handling base64 image data, and managing user avatars and favicons. Users will benefit from improved file upload reliability, better handling of secure storage configurations, and enhanced support for various image formats and external storage backends.

app/Uploads · high confidence

Restructured application layout system with new base template and tri-layout

The application's view structure has been reorganized to introduce a new \layouts/base.blade.php\ as the central template, which now handles core meta tags, PWA manifest links, OpenSearch support, and dynamic dark-mode class application. This base template is extended by \layouts/tri.blade.php\, which implements a new three-column layout with mobile-responsive tab switching for sidebar navigation, and \layouts/simple.blade.php\, providing a streamlined two-column structure. Additionally, dedicated layouts for \export.blade.php\ and \plain.blade.php\ have been created to ensure correct rendering for exported content and plain-text views respectively.

resources/views/layouts · high confidence

Restructured authentication services and added login timing defenses

The authentication logic in app/Access has been reorganized into dedicated service classes (EmailConfirmationService, GroupSyncService, LdapService, LoginService, RegistrationService, Saml2Service, SocialAuthService, SocialDriverManager, UserInviteService, and UserTokenService) to improve maintainability. As part of this restructuring, the login flow now includes timing defenses: failed login attempts introduce a random delay (0–250ms) and perform a dummy hash check to mitigate timing-based user enumeration attacks. Additionally, the system now supports an AUTH\_PRE\_REGISTER theme event, allowing themes to intercept and prevent user registration before the user is created.

app/Access · high confidence

Restructured email notifications into domain-specific classes

Email notifications for account confirmation, password resets, and user invitations have been reorganized into dedicated classes within the Access/Notifications directory. This change improves the maintainability of the authentication flow by isolating the logic for each specific email type, ensuring that users receive correctly localized and contextualized messages for these critical account actions.

app/Access/Notifications · high confidence

Restructured settings interface with new navigation and color customization options

The settings area has been reorganized into modular view components to improve layout and functionality. A new navigation bar (navbar) has been introduced to manage access to sub-sections like maintenance, audit, users, roles, and webhooks based on user permissions. The interface now supports granular color customization for both light and dark modes, allowing users to adjust app, link, and content element colors via a dedicated color picker. Additionally, the footer links section has been updated to support dynamic, sortable lists of links, and the user display in settings tables has been standardized to show avatars and names.

resources/views/settings/parts · high confidence

Search engine refactored with structured options and new negation support

The search system in app/Search has been restructured to use a typed SearchOption hierarchy (Term, Exact, Tag, Filter) and a SearchOptionSet container, replacing the previous ad-hoc parsing. This change introduces support for negating search terms (using a leading minus sign) across exact phrases, tags, and filters, and adds limits on the number of search options to prevent abuse. It also includes a new SearchTextTokenizer for more robust term splitting, updated search result formatting to highlight matches, and new API endpoints (SearchApiController) for searching all entities, books, and chapters.

app/Search · high confidence

Standardized auth form partials and added theme placeholders

The authentication views have been reorganized into specific partials for each login method (standard, LDAP, OIDC, and SAML2) to establish a consistent file convention. Additionally, placeholder message templates for login and registration have been added to support the visual theme system, allowing themes to easily override these specific UI elements.

resources/views/auth/parts · high confidence

TinyMCE editor updated to version 6.8.4

The TinyMCE editor library has been upgraded from version 6.8.3 to 6.8.4. This update includes the latest minified source code for the lists and table plugins, ensuring that list formatting and table editing behaviors reflect the changes and fixes present in the 6.8.4 release.

public/libs/tinymce/plugins/lists, public/libs/tinymce/plugins/table · high confidence

Updated TinyMCE editor library

The TinyMCE WYSIWYG editor library has been updated to a newer version. This change includes updated core files, plugins, themes, and skin assets (including dark mode support), which may bring bug fixes, performance improvements, and styling updates to the rich text editing experience.

public/libs/tinymce · medium confidence · unverified

Updated application namespace and console command registration

The application's namespace has been changed from 'Oxbow' to 'BookStack', affecting the console kernel. Additionally, the method for registering Artisan commands has been updated to use the \commands()\ method with dynamic loading from the \Commands\ directory, replacing the previous static array definition that included the \Inspire\ command.

app/Console · high confidence

Updated public entry point and server configuration for Laravel compatibility

The application's public entry point (index.php) has been refactored to align with modern Laravel standards, replacing the legacy bootstrap/autoload process with direct Composer autoloading and explicit request handling. Additionally, server configuration files have been updated: the Apache .htaccess now includes rules to properly handle Authorization headers and disable directory indexing, while a new IIS web.config file has been added to support URL rewriting on Windows servers.

public · high confidence

User management logic consolidated into UserRepo

The user management logic has been consolidated into a new \UserRepo\ class, which centralizes operations for creating, updating, and retrieving users. This change introduces stricter matching for external authentication IDs to prevent ambiguous lookups, adds support for user-specific language and dark-mode display preferences, and ensures slugs are regenerated when a user's name or email is updated.

app/Users · high confidence

Fixes

Add database initialization script for PHP tests

A new SQL initialization script (01.sql) has been added to the Docker environment setup. This script creates the 'bookstack-test' database and grants all privileges to the corresponding user, ensuring the required test database exists for PHP test execution.

dev/docker/init.db · high confidence

Added database factories for User and Role models

New factory classes have been added for the User and Role models to support test data generation. The UserFactory generates users with a name, email, slug, random password, and confirmed email status, while the RoleFactory creates roles with a display name, description, and empty external auth ID. These changes fix failing references caused by a recent controller and file restructuring.

database/factories/Users · high confidence

Test coverage

Added API Token factory for database seeding; Added comprehensive test coverage for entity management features; Added comprehensive test coverage for entity permissions and ownership changes; Added comprehensive test coverage for the API; Added comprehensive test coverage for the uploads subsystem; Added comprehensive test coverage for user management, roles, and preferences; Added comprehensive test suite for authentication and identity providers; Added comprehensive test suite for search functionality; Added database factories for Activity module models; Added database factories for Uploads models; Added database factories for core entity models; Added factory for generating test Import records; Added test coverage for Activity module components; Added test coverage for BookStack CLI commands; Added test coverage for Settings module features; Added test coverage for WYSIWYG editor services; Added test coverage for export and import functionality; Added test data fixtures for image and upload testing; Added tests for URL filtering, SSR validation, and date formatting utilities; Added tests for book sorting, entity moving, and sort rule management; Added tests for entity and role permission scenarios; Added tests for meta endpoints and PWA manifest behavior; Added tests for the reference tracking system and cross-link parser; Added tests for the theme system's event hooks, module loading, and view overrides; Added tests for view layout editing, block defaults, and header accessibility; Added unit tests for configuration, OIDC, and include parsing logic; Initial test suite and test infrastructure; New WYSIWYG utility functions and tests for content manipulation; New test helper classes for entities, permissions, and OIDC.

Dependencies

Major dependency overhaul: Laravel 12, PHP 8.3, and modernized build tooling

This change updates the project's core dependencies and build infrastructure. The PHP runtime requirement is raised to 8.3, and the framework is upgraded to Laravel 12.26.4. The build system has shifted from Gulp/Laravel Elixir to esbuild for JavaScript and Sass for CSS, with new npm scripts for development and production builds. JavaScript dependencies now include CodeMirror 6, Markdown-it, and Snabbdom, while PHP dependencies include Intervention Image 3.5, DOMPDF 3.1, and OneLogin PHP-SAML 4.3.1. Development tools have been updated to PHPUnit 11.5, ESLint 10, and TypeScript 6.0.

(dependencies) · high confidence

TinyMCE upgraded to version 6.8.4

The TinyMCE editor library has been updated from version 6.7.2 to 6.8.4. This upgrade includes updated versions of the advlist, charmap, and preview plugins, bringing the editor to the latest stable release with associated bug fixes and improvements.

public/libs/tinymce/plugins/advlist, public/libs/tinymce/plugins/charmap, public/libs/tinymce/plugins/preview · high confidence

Housekeeping

Added API request examples for core resources

Added JSON and HTTP request example files for creating, updating, and deleting resources across the API, including books, chapters, pages, shelves, attachments, comments, image galleries, tags, roles, and users. These examples serve as documentation and testing references for the API endpoints.

dev/api/requests · high confidence

Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.

How this codebase got here

Score

  • CAI 47 → 48 (+0.5)
  • Rubric changed (rubric-2026.10.5 → rubric-2026.11.2) — scores are not directly comparable.

Lenses

  • Code Health 46 → 46 (+0.0)
  • Architecture 61 → 64 (+3.3)
  • Maturity 54 → 61 (+6.2)
  • Readiness 43 → 43 (-0.1)
  • Security 72 → 73 (+1.1)
  • Domain Modelling 64 → 64 (+0.1)
  • Accessibility 48 → 48 (-0.4)
  • Performance 100 → 100 (+0.0)

Resolved (152)

  • Change coupling: index.blade.php ↔ index.blade.php (resources/views/books/index.blade.php)
  • Change coupling: index.blade.php ↔ list.blade.php (resources/views/books/index.blade.php)
  • Cross-context type Attachment (Uploads → Exports) (app/Exports/ZipExports/Models/ZipExportAttachment.php)
  • Cross-context type Attachment (Uploads → Exports) (app/Exports/ZipExports/ZipExportFiles.php)
  • Cross-context type Attachment (Uploads → Exports) (app/Exports/ZipExports/ZipImportReferences.php)
  • Cross-context type Attachment (Uploads → References) (app/References/ModelResolvers/AttachmentModelResolver.php)
  • Cross-context type Book (Entities → Exports) (app/Exports/ExportFormatter.php)
  • Cross-context type Book (Entities → Exports) (app/Exports/ExportFormatter.php)
  • Cross-context type Book (Entities → Exports) (app/Exports/ExportFormatter.php)
  • Cross-context type Book (Entities → Exports) (app/Exports/ExportFormatter.php)
  • Cross-context type Book (Entities → Exports) (app/Exports/ZipExports/Models/ZipExportBook.php)
  • Cross-context type Book (Entities → Exports) (app/Exports/ZipExports/ZipExportBuilder.php)
  • Cross-context type Book (Entities → Exports) (app/Exports/ZipExports/ZipImportReferences.php)
  • Cross-context type Book (Entities → Sorting) (app/Sorting/BookSorter.php)
  • Cross-context type Chapter (Entities → Exports) (app/Exports/ExportFormatter.php)
  • Cross-context type Chapter (Entities → Exports) (app/Exports/ExportFormatter.php)
  • Cross-context type Chapter (Entities → Exports) (app/Exports/ExportFormatter.php)
  • Cross-context type Chapter (Entities → Exports) (app/Exports/ExportFormatter.php)
  • Cross-context type Chapter (Entities → Exports) (app/Exports/ZipExports/Models/ZipExportChapter.php)
  • Cross-context type Chapter (Entities → Exports) (app/Exports/ZipExports/ZipExportBuilder.php)
  • …and 132 more

New (27)

  • Change coupling: PageRepo.php ↔ PageEditorData.php (app/Entities/Repos/PageRepo.php)
  • Duplicated block (11 lines × 2) (database/factories/Entities/Models/PageRevisionFactory.php)
  • Low CVE: [GHSA redacted] (package-lock.json)
  • Medium CVE: [GHSA redacted] (package-lock.json)
  • Medium CVE: [GHSA redacted] (package-lock.json)
  • Medium CVE: [GHSA redacted] (package-lock.json)
  • Medium CVE: [GHSA redacted] (package-lock.json)
  • Outdated: onelogin/php-saml
  • Outdated: predis/predis
  • doc comments repeat the names (resources/js/components/auto-suggest.js)
  • redundant comment (resources/js/components/entity-permissions.js)
  • redundant comment (resources/js/components/image-manager.js)
  • redundant comment (resources/js/components/image-manager.js)
  • redundant comment (resources/js/components/image-manager.js)
  • redundant comment (resources/js/components/page-editor.js)
  • redundant comment (resources/js/components/pointer.ts)
  • redundant comment (resources/js/components/pointer.ts)
  • redundant comment (resources/js/components/template-manager.js)
  • redundant comment (resources/js/components/template-manager.js)
  • redundant comment (resources/js/markdown/shortcuts.ts)
  • …and 7 more

Changes since last survey

  • 9 commits — 9 feature/other, 0 fixes

By area

  • app/Entities — 6 commits
  • (repo) — 1 commit
  • database/migrations — 1 commit
  • tests/Entity — 1 commit

Notable commits

  • change: Drafts & Revisions: Split logic out to their own classes
  • change: Merge pull request 'Revision System Cleanup' (#6258) from revision_numbering into development
  • change: Page Update Drafts: Added changelog support
  • change: Revisions: Added new number-based show/changes endpoints
  • change: Revisions: Added tests to cover legacy paths and numbering
  • change: Revisions: Split out drafts from page_revisions table
  • change: Revisions: Updated UI to use revision_number consistently
  • change: Revisions: Updated numbering to ensure a maximum
  • change: Revisions: Updated use of the page revision_count

Architecture

  • Unchanged — 0 containers · 1 contexts · 0 edges

Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.

Survey your own repository

BookStackApp/BookStack was measured the same way every project in this corpus was: the same rubric, at a pinned commit, with the result published in full. Point a surveyor at a repository you know and see whether you agree with it.

About this page

  • The score is its most recent published measurement, taken on 10 November 2026 at a pinned commit. It is not a live figure and does not change until the project is measured again.
  • Measured at commit 0b6b667e0d84ebb3406de6de9fadbf4230c29c0b — the exact code this score is about.
  • Scored under rubric-2026.11.2 — the same rubric and the same method as every other entry in this index.
  • Measured by Canine Code Analyzer (cca.canine.dev) using cca measure-2026.11.12+preprod-0a1a03138314.