How to set up TiddlyPWA

I have a wiki currently on Node.js (running locally). Eventually I want to make it publicly available and a PWA solution seems to meet my needs. However, I am having difficulty seeing how to actually set up TiddlyPWA.

The tiddlywiki.com page points to the developer’s page https://tiddly.packett.cool/ which does not seem to have any actual installation instructions. A search on https://talk.tiddlywiki.org/ raises a number of issues folk have had, but no ‘How to’.

I have my own webspace and have exported my Node.js wiki there, but would prefer the mobile friendly/offline options.

Could someone provide a few notes please.

Thanks.

https://tiddly.packett.cool/#ServerHosting%2FDIY

Yes it’s possible to get there from the main page

  1. Go to https://tiddly.packett.cool
  2. Search for “Host a Sync Server”, which is a link pointing to TiddlyPWA — TiddlyWiki Storage & Sync Solution
  3. On that page search for “Host on a computer”, which is a link pointing to TiddlyPWA — TiddlyWiki Storage & Sync Solution

I believe that’s what you need.

This is strictly about finding the info, I’ve no experience doing this myself so I can’t assist you further I’m afraid.

1 Like

For anyone else following along, I have got this far. I have also set-up Deno locally and can get to it control panel running on http://localhost:8000/

I then created a new wiki which creates a new token and tells me the url is http://localhost:8000/tid.dly

Then on my wiki in the synchonisation settings I add the url and token. There is an “Add” button to click but nothing apparently happens. If you go to the url http://localhost:8000/tid.dly there is no wiki there - just an error message {"error":"EPROTO"}

There is clearly a problem here, maybe with the plugin, as when you close the Control Panel and reopen it the settings have not been saved.

I am having difficulty seeing how to actually set up TiddlyPWA

Well, the expected flow is that you just click “Go” on the website :slight_smile:

(and then, once you decide to proceed to a multi-device setup, you read the whole “setting up a sync server” part)

but I’m definitely missing some “guide for existing users” there, sorry.

There is an “Add” button to click but nothing apparently happens

Very strange. The add button should work even if you put arbitrary junk there:

Does anything appear on the browser’s JS dev console? What browser are you using?

How is “your wiki” set up? Do not install the TiddlyPWA plugin into existing wikis that use another sync method. That’s not how it works.

You can use the sync server settings with the “add” button from an existing TiddlyPWA wiki that you’ve already started filling in a single-device setting, i.e. via the “try now” thing above. (After first syncing the content, you’ll also be able to upload the app wiki to the server right from there.)

If you want to get started directly on a sync server, just UploadApp first, then visit the uploaded URL. The API endpoint will be preconfigured automatically.

In any case, if you want to import content from an existing wiki, you need to use the actual export & import functionality (including drag&drop).

If you go to the url http://localhost:8000/tid.dly there is no wiki there

That’s the API endpoint, not the URL for the wiki itself. (Definitely should add some dummy HTML for anyone accidentally visiting it with a browser!)

The app wiki URL as hosted by the sync server will appear in the control panel once you do UploadApp. (Well, also directly in the upload form.)

That ‘Add’ fom appears in the plugin/control panel.

It’s a wiki I run locally on node.js. I normally use Brave.

So, where/when is the plugin installed?

I do want to use it for my exisiting wiki.

@telumire has two great tiddlypwa videos showing how to create a new wiki and how to import an existing single-file wiki.

To get a single-file wiki it should work to open your node.js wiki in your browser, visit the $:/core/ui/DownloadFullWiki and click the download button. There are lots of other ways to accomplish the same.

Then follow along with the second video using your single-file wiki.

1 Like