jokroese / tiddlyroam

Your open source external brain
https://tiddlyroam.org
BSD 2-Clause "Simplified" License
563 stars 29 forks source link
roam roamresearch tiddlywiki tiddlywiki5 wiki

TiddlyRoam

Your open-source external brain.

Description

TiddlyRoam is an open-source tool for organising your thoughts, ideas, and research by building your own personal wiki. It’s designed to capture your knowledge in small, interconnected notes and help you discover new patterns through bi-directional links.

The project provides a free and open-source alternative to the popular Roam, built on the highly customisable TiddlyWiki.

Key Features

How to Use TiddlyRoam

TiddlyRoam is designed for everyone—no technical skills required! You can start using it right away by following the steps below:

  1. Download the latest version of TiddlyRoam:
  2. Download TiddlyDesktop:
    • Install TiddlyDesktop, which allows you to save your changes easily.
  3. Run TiddlyRoam:
    • Open TiddlyDesktop.
    • Drag the tiddlyroam.html file into the TiddlyDesktop window or use the file picker to open it.
    • Start adding your notes, and TiddlyRoam will help you organise them!

Quickstart for Development

If you’re a developer interested in customising or contributing to TiddlyRoam, follow these steps to set up the development environment using a modular, Node.js-based workflow.

  1. Clone the repository:
    git clone https://github.com/jokroese/tiddlyroam.git
    cd tiddlyroam
  2. Install dependencies:
    npm install
  3. Start the development server:
    npm run dev
  4. Open your browser and navigate to http://localhost:8080 to see the live TiddlyWiki.
  5. To build the distributable single HTML file:
    npm run build

    This will generate the tiddlyroam.html file for distribution.

Acknowledgements

TiddlyRoam combines the amazing work of the following open-source projects:

I hope this is useful for you Ellis.

License

This project is licensed under the BSD 2-Clause License. You are free to use, modify, and distribute the software with attribution, as long as you follow the license terms.