Brahin – personal wiki software
This is an experiment to create a web-based wiki software with the focus on speed – you shouldn't need to wait for a big application to load to access your notes. Brahin is built with the progressive enhancement principle in mind: initially the content is loaded as a simple HTML pages, while the core application modules are loaded in the background; additional modules are loaded only when needed.
web-based WYSIWYG editor based on Slate
linking between pages
auto-saving to the server or to the browser's local storage
permissions: grant read/write/create/admin rights via access tokens
There are two easy ways to try it out – no signup or setup required:
Local/Temporary – go to your local area –
/_local– anything under this path is stored in the browser's local storage using PouchDB and will never be synced to the server. You can't share this with anyone. Warning: the Clear Offline Website Data or similar feature will remove this data.
Cloud – create pages under
yourname– this will be auto-saved to the server, and you can share it with others by clicking Permissions at the bottom of the page.
Formatting: ⌘1-6 heading, ⌘B bold, ⌘I italic, ⌘U underline, ⌘H inline code
Lists: ⌘L bullet list, ⌘⇧N numbered list, ⌘K task list
Links: ⌘⇧I insert link, ⌘E edit link URL and label
Limitations & known issues
a recent Firefox or Chrome browser is required
no conflict resolution – if you edit the same page in multiple windows, the last change will overwrite any changes made in a different window
/_localdoesn't work in Private Browsing mode in Firefox
To create your own installation:
Deploy to Heroku – no technical knowledge required; Heroku's free tier works well, except that there will be a slower page loading time if the app hasn't been used for a while
Deploy with Dokku – for techie people
Note: The first user to visit a fresh installation will automatically be given ownership rights; the token will be saved as a cookie. To ensure you don't lose this token click Permissions at the bottom of the main page, copy the link with the own right, and save it somewhere safe, like a password manager.
The source code is available under the MIT licence:
brahin-backend – back-end (Ruby on Rails)
12 October 2018 – v0.4 – Git storage & synchronisation
9 September 2018 – v0.3 – Sharing with tokens, permission management
Please submit bug reports and feature requests using the GitHub issue handler on the most appropriate repository above.
For any other queries or feedback, please send an email to: firstname.lastname@example.org.
Author: Levente Bagi