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

Yet another migration, i am SO SO sorry. This should be the last - big - one.

The biggest challenge with this app has been creating advanced features (like bidirectional linking) without a database.
This update will allow me to go absolutely CRAZY with ideas/features without the worry of immutability.

As always please back up your data before migrating. It should be quite straight forward and harmless, but it's your precious data and I want to make sure it's treated properly.

This migration will add yml metadata to all your notes/checklists. Please read more about yaml frontmatter if you are worried/need any clarification on why

Changelog

bugfixes

• Weird behaviour on pinned items where sometimes clicking didn't work, dragging is more reliable now
• Allow users to decide (profile -> settings) how much sanitation should happen on title edit (if any) #204
• Added three dots for more option to active items in the sidebar
• Fix first oidc user breaking if user.json and session.json files are missing #200
• Fix <mark> highlighted text contrast, now dark colors will show white text, light colors will show dark text. #185
• Fix issue where on first load users don't have permissions to edit notes/checklist

Api changes

(may break existing calls, so read this if you use the api)

• Fetching notes/checklists via api now uses a uuid that can be copied clicking on the # symbol next to note name/checklist name
• Added update note api endpoint
• Jotty now has a full openapi documentation in place. You can either host it locally following the howto/API.md documentation (or clicking the question mark in the header and going to the api tab) or checking it out on the official https://api.jotty.page <-- this page briefly goes down every 6 hours due to the data being automatically reset on the jotty demo page. This should not be treated as a production api documentation, it's just an example of what it'll look like when you self host it for yourself. I may take it down at some point, we'll see.

Features

global features

• Introducing YAML Frontmatter to every note/checklist added to jotty, this will add metadata at the top of the file (title/uuid/checklistType) and will make it so much easier to handle queries. Most notes app use this, the metadata won't be visible on the frontend but it will be adde at the top of your markdown files (if they already have it from previous apps, it'll just add uuid and checklistType to it and keep the rest as is, full compatibility with majority of other apps is always my goal).
• Entirely re-factoring how bidirectional linking works with using immutable uuids, this will make it extremely easy to keep track of linking, internal url will look like this /jotty/<uuid_here> and they will automatically link notes to other notes via the same .index.json file, which the migration will automatically update with your links (all your existing linking SHOULD still be working after migrating but you may need to re-save the notes that have the links).
  • I have also added a handy button in the internal links where you can choose to opt out of that link being bi-directional, which will just convert it back to a normal /note/<note_path> or /checklist/<checklist_path>. This will obviously remove the bidirectional link, but will preserve your links in human readable format. I want to make sure that your data doesn't have too much proprietary stuff unless you WILLINGLY choose to use it. Similarly if you type @ the link will default to /jotty/<uuid_here> but you can switch it to a normal link there and then by clicking on the bidirectional toggle within the link element (you'll see when you use it, it's pretty intuitive).
• Entirely re-factoring how the sidebar drag/drop behaves, including allowing notes to be dragged into different categories and categories to be dragged into different subcategories. This is a major quality of life improvement in my eyes.
• Sharing also uses uuid, you won't notice any difference, but it's good to explain these things. The migration will take care of your existing sharing data, so nothing should change for you.
• Timezone can be set in both dd/mm/yyyy and mm/dd/yyyy formats from user->settings thanks to the great work @prajwal0024 did #190

checklist features

• Entirely re-factoring how checklists drag/drop behaves, it's way less janky and works just like the sidebar (i did one, may as well do both 😆 )
• Kanban board now has customisable status columns (individually customisable per kanban board)
• Kanban board columns order/colors can be fully customisable (individually, per kanban board)
• Kanban board items can now be archived/unarchived #213

notes features

• Integrate diagrams to note editor (this is SO cool)
  • Full native markdown integration (with visual editor) for mermaid.js #147
  • Full embedded integration with draw.io - diagrams.net but with the ability to add a offline draw.io instance from the admin->editor settings. #144

As always if there are any problems/bugs/weird behaviour open an issue and/or message me on the official discord. I usually get on top of these quite fast, especially on release evenings.