Join the discord to stay up to date and have early previews

Attention big changes

This update may break some of your sharing functionality.
I have added a forceful migration on first launch which will take your data/sharing/shared-items.json file and convert into the two new .sharing.json files within the notes and checklists folders.

This should take care of all cases, I have tested it with a bunch of scenarios in mind and HOPEFULLY all your sharing relationships will stay intact. I still highly suggest you backup that shared-items.json file (and all your data ideally) before attempting the migration. (the migration also backs up the file, but again, better safe than sorry, it's your data after all).

This was due to a major refactor around sharing, you can now use more granular permission (view/edit/delete) and it's 10x more performing. Everything should feel more... snappy! :)

All items that were shared before this update will be converted to automatically have read, write and delete permissions for users that are shared with, the old sharing automatically granted FULL permission, so I'll keep it as it was, you'll need to go through your checklists/notes and change them accordingly if you want to restrict certain accesses (new feature from this release).

note for docker users: You will need to update the config volume mapping in your docker-compose.yml file from ./config:/app/config:ro to ./config:/app/config:rw if you want to use the new theme/customisation functionality coming with this update.

Changelog

BIG performance improvements

Due to the lack of a database we need to start making some compromises if we want the app to keep feeling lightweight even with tons of files loaded at once. This is why from this version onwards the sidebar will only be showing a stylised version of the filenames rather than the actual title of the files - e.g. before it was reading the first Heading if one was present, now it's reading the file names, replacing - with spaces.

Believe it or not, this minor change exponentially improves performance. I am open to add a setting in the future to let users choose if the data should always be parsed or not, I kept all the legacy parsing functions intact for now, but I don't think most users would truly understand the repercussions of said action. Feel free to open an issue to change my mind on this, I'm always open minded to being challenged on my ideas.

Bugfixes

• Fix notes filter and notes page in general #165
• Fix system theme flashing before real theme is loaded #172
• Fix custom themes not available in profile->settings #171
• Fix PWA splash screen to match user theme #162 (read documentation)
• Fix PWA icons to use theme icons #186
• Fix SSO requesting groups for providers that have it by default (e.g. Entra)

Features

Global

• Add new icon types for android/apple PWA home screen icon (profile -> settings)
• Allow full customisation override for PWA splash screen/icons (read documentation)
• Create/Edit theme straight from the UI in admin -> styling
• Ability to add custom css from admin -> styling (I have also added specific classes here and there across the whole application so you can target elements better, I'll keep adding more with future releases as i edit the code when fixing bugs/adding new features).
  • note for docker: For both new themes and custom css you will need to update the config volume mapping in your docker-compose.yml file from ./config:/app/config:ro to ./config:/app/config:rw.
• Allow delete from sidebar
• Allow archive from Checklist/Task/Note specific page with a handy archive button
• in admin -> content there's a new button to fix linking for users, in case of manual deletion of files this should be triggered. I have created an api endpoint /api/admin/rebuild-index in case you want to make a cron of it. check the api documentation for more info.
• COMPLETELY REFACTORED sharing
  • More granular permissions (view/read/delete) #102
  • Share files now sit within notes and checklists in your data folder, they are called .sharing.json
  • New sharing admin view with better data visualization

Notes

• Bidirectional linking notes/checklists (beta feature, only works for own items and not shared items) #106
  • Type @ in the editor to show possible links
  • Click on a link, it'll add it to the editor, hovering on it will show a preview, in the linked article/checklist there'll be a new section showing every time it has been referenced.
  • New profile tab added with a nice visual representation of your notes/checklists relationships

Checklists

• Recurring checklist items/task items - beta - this will need to be enabled in profile -> settings (thank you @JTCorrin !!) #82
• Nested subtasks will automatically collapse if a parent is completed #176
• Add suggestion to uncheck already checked items - if you find this annoying it can be disable in profile -> settings #150 #188

New api endpoints

• /api/health - GET | no authentication required
• /api/manifest - GET | no authentication required

Conclusions

This is probably the biggest release since I have launched the app (even bigger than the rebranding).
I have had to refactor a lot in order to make the bidirectional linking performing up to standard and while doing so I inevitably ended up adding new features that have been in the work for ages.

This may result in a few bugs, please don't be shy to either raise them in the issues tab in the repo OR join discord and let me know there. I'll try to address everything coming my way as soon as I possibly can, in order of urgency, prioritising breaking changes (there shouldn't be any, btw, i'm just being cautious, I am one person, and I can do with all the help I can get, stuff slips through my testing at times, and I apologise for that.

Have fun with all the new updates ❤️