# Bookstack Dev Notes # Single Type Limited Access UX Experiments Bookstack has some predefined roles, but roles can be created such that they have read access limited to: - Books - Chapters - Pages Interface for users with read permissions strictly limited to those types changes dynamically. See: [https://github.com/BookStackApp/BookStack/issues/1171#issuecomment-446378261](https://github.com/BookStackApp/BookStack/issues/1171#issuecomment-446378261) [They](https://github.com/BookStackApp/BookStack/issues/1171#issuecomment-446378261) do appear to all have access to the page set as the landing page. #### Permissions Grid [![Screenshot 2025-02-19 at 10.26.33 AM.png](https://fortunate-mink.pikapod.net/uploads/images/gallery/2026-08/scaled-1680-/screenshot-2025-02-19-at-10-26-33-am-png.png)](https://fortunate-mink.pikapod.net/uploads/images/gallery/2026-08/scaled-1680-/screenshot-2025-02-19-at-10-26-33-am-png.png) #### Pages only interface Pages only user: - has the Books menu item - can see the homepage - maybe can't edit homepage? (~LP) - can see other pages, (I don't believe there's a page that lists all pages ~LP) [![Screenshot 2025-02-19 at 11.31.41 AM.png](https://fortunate-mink.pikapod.net/uploads/images/gallery/2026-08/scaled-1680-/screenshot-2025-02-19-at-11-31-41-am-png.png)](https://fortunate-mink.pikapod.net/uploads/images/gallery/2026-08/scaled-1680-/screenshot-2025-02-19-at-11-31-41-am-png.png) [![Screenshot 2025-02-19 at 11.31.29 AM.png](https://fortunate-mink.pikapod.net/uploads/images/gallery/2026-08/scaled-1680-/screenshot-2025-02-19-at-11-31-29-am-png.png)](https://fortunate-mink.pikapod.net/uploads/images/gallery/2026-08/scaled-1680-/screenshot-2025-02-19-at-11-31-29-am-png.png) #### Books only interface Pages only user: - has the Books menu item - can see the homepage - can see/edit books (duh) [![Screenshot 2025-02-19 at 11.30.19 AM.png](https://fortunate-mink.pikapod.net/uploads/images/gallery/2026-08/scaled-1680-/screenshot-2025-02-19-at-11-30-19-am-png.png)](https://fortunate-mink.pikapod.net/uploads/images/gallery/2026-08/scaled-1680-/screenshot-2025-02-19-at-11-30-19-am-png.png) [![Screenshot 2025-02-19 at 11.15.22 AM.png](https://fortunate-mink.pikapod.net/uploads/images/gallery/2026-08/scaled-1680-/screenshot-2025-02-19-at-11-15-22-am-png.png)](https://fortunate-mink.pikapod.net/uploads/images/gallery/2026-08/scaled-1680-/screenshot-2025-02-19-at-11-15-22-am-png.png) #### [![Screenshot 2025-02-19 at 11.30.46 AM.png](https://fortunate-mink.pikapod.net/uploads/images/gallery/2026-08/scaled-1680-/screenshot-2025-02-19-at-11-30-46-am-png.png)](https://fortunate-mink.pikapod.net/uploads/images/gallery/2026-08/scaled-1680-/screenshot-2025-02-19-at-11-30-46-am-png.png)Chapters only interface Chapters only user: - has the Books menu item - can see the homepage - can see/edit chapters (duh) [![Screenshot 2025-02-19 at 11.24.20 AM.png](https://fortunate-mink.pikapod.net/uploads/images/gallery/2026-08/scaled-1680-/screenshot-2025-02-19-at-11-24-20-am-png.png)](https://fortunate-mink.pikapod.net/uploads/images/gallery/2026-08/scaled-1680-/screenshot-2025-02-19-at-11-24-20-am-png.png) [![Screenshot 2025-02-19 at 11.19.16 AM.png](https://fortunate-mink.pikapod.net/uploads/images/gallery/2026-08/scaled-1680-/screenshot-2025-02-19-at-11-19-16-am-png.png)](https://fortunate-mink.pikapod.net/uploads/images/gallery/2026-08/scaled-1680-/screenshot-2025-02-19-at-11-19-16-am-png.png) # Misc Dev Notes ##### User name change error Had an "unrecognized user name" error when I changed a test user name via admin panel and then tried to log in. Logged in fine with email. I'd changed my personal account name from the keycloak created hash without issue, so maybe issue is that the admin did it in this case? Or maybe I screwed it up, haven't tried to replicate. ##### ACL Strategy Permissions can be overridden for specific Shelves/Books/Chapters/Pages, and they do inherit, but overrides are per defined role, so if many roles exist, there's a need for nearly redundant sets of overrides for each role. ##### 1st SSO login issue [https://github.com/BookStackApp/BookStack/issues/4436#issuecomment-1684113880](https://github.com/BookStackApp/BookStack/issues/4436#issuecomment-1684113880) ##### Mobile Breadcrumbs Mobile breadcrumbs are just icons, and kinda mushy. Might be nice to have Book name, even truncated with ... ~LP ##### Adding CSS or content based on page tags Interesting tip that could be used during an import process, or also to add hero banners or something to specific tags. [https://excessivelyadequate.com/posts/booksthack.html#displaying-banners-or-making-other-style-changes-based-on-tags](https://excessivelyadequate.com/posts/booksthack.html#displaying-banners-or-making-other-style-changes-based-on-tags) # Combo Books/Pages Permissions Testing Testing users with a role that limits them to view/edit Books and Pages. - User has access to Books menu item - User had breadcrumbs for Book List/Book/Page [![Screenshot 2025-02-19 at 12.33.02 PM.png](https://fortunate-mink.pikapod.net/uploads/images/gallery/2026-08/scaled-1680-/screenshot-2025-02-19-at-12-33-02-pm-png.png)](https://fortunate-mink.pikapod.net/uploads/images/gallery/2026-08/scaled-1680-/screenshot-2025-02-19-at-12-33-02-pm-png.png) [![Screenshot 2025-02-19 at 12.37.33 PM.png](https://fortunate-mink.pikapod.net/uploads/images/gallery/2026-08/scaled-1680-/screenshot-2025-02-19-at-12-37-33-pm-png.png)](https://fortunate-mink.pikapod.net/uploads/images/gallery/2026-08/scaled-1680-/screenshot-2025-02-19-at-12-37-33-pm-png.png) # Wiki organization proposals Possible wiki structure, including functioning as a general home page for WB. Uses Books/Chapters/Pages This was the first thing that came to mind, but seems like maybe Minutes and Proposals want to be books because they'll get big, and I'm not sure how the logical separation affects stuff like page link pickers, media pickers, etc.. ~LP This diagram was made in the wiki, it can be double clicked to edit.
drawing-7-1739990788.png