The https://pondersource.com/ website
This is a static site, with dependencies checked in. No build or application secrets are needed. Serve the repository root (rather than opening the HTML as a file) so browser storage and JavaScript modules work:
python3 -m http.server 8000 --bind 127.0.0.1The App store contains six apps with links to the Ponder Source forks and
upstream source. Each app uses its Ponder Source deployment at
https://APP_NAME.pondersource.com. Todonna uses GitLab Pages; the other five
use GitHub Pages. Installing adds a shortcut to My apps; launching opens the
app's website. Removing a shortcut
also removes it from Recently used, without deleting any data in the app itself.
The catalog and its source links live in index.html.
Without a connected account, installed apps and launch history are stored in the browser's Origin Private File System (OPFS), with localStorage as a fallback when OPFS is unavailable. This storage belongs to this site's origin and browser profile. Clearing site data removes it; it is not an offline copy of the apps. Secure contexts (HTTPS, or localhost during development) are needed for OPFS. Storage errors are shown instead of claiming an installation was saved.
Connecting an account loads that account's library. Copy this device's apps to this account explicitly adds local installations without removing account apps. Signing out restores the device's separate library. Installations made while connected stay with that account; they aren't copied into the device library.
The remote library uses the vendored remoteStorage.js library, the launcher:rw
scope, and /launcher/installed-apps. The versioned document records each app's
installation status, modification time, and last launch. Removal records are
retained so merging another device's older state cannot reinstall a removed app.
Changes to different apps are merged; changes to the same app use the most recent
timestamp (removal wins ties), so device clocks should be reasonably accurate.
The library caches connected data and queues writes for synchronization. The UI
does not claim a queued write has already reached the provider.
The previous /launcher/recent-apps document is left intact. The new Recently used
view tracks launches of installed apps in the versioned library. Storage-first
#remotestorage=user%40provider addresses are still accepted and carried to
launched apps. Google Drive and Dropbox addresses are not passed as remoteStorage
discovery addresses.
Both backends are included in remoteStorage.js and use the same library document.
To enable their connection buttons, register OAuth applications with the provider
and populate the public client identifiers in
assets/js/launcher-config.mjs:
export const storageApiKeys = {
googledrive: 'YOUR_CLIENT_ID.apps.googleusercontent.com',
dropbox: 'YOUR_DROPBOX_APP_KEY'
};These are public application identifiers, not user tokens or client secrets.
Register the exact redirect URI emitted by remoteStorage.js: at the site's root
this is the origin without a trailing slash, e.g. https://pondersource.com
(locally, http://127.0.0.1:8000). Provider settings must permit that origin and
the permissions requested by the bundled backend. Each user then authorizes
their own account through the provider. Unconfigured buttons stay hidden.
The bundled library supports remoteStorage, Google Drive, and Dropbox. It does not include Solid Pod or Atomic adapters; those require a separate integration.
Storage and merge tests have no dependencies beyond Node.js:
node --test tests/launcher-storage.test.mjsBrowser tests need Playwright and Chromium. For example, install the test tools outside the checkout:
npm install --prefix /tmp/pondersource-browser-tests --no-package-lock playwrightKeep the static server running, then run:
NODE_PATH=/tmp/pondersource-browser-tests/node_modules \
CHROMIUM_PATH=/usr/bin/chromium \
node --test tests/launcher-browser.test.cjsSet CHROMIUM_PATH to your Chromium executable, or omit it to use Playwright's
installed browser. Set LAUNCHER_TEST_URL if using a different local server URL.
The browser suite checks real OPFS, browser-storage fallback, persistence, launch
history, removal, concurrent tabs, corruption, mobile layout, and keyboard tabs.
It exercises the actual vendored remoteStorage.js against a simulated provider
for authorization, account isolation, sync, and a fresh device. Google Drive and
Dropbox tests check OAuth initiation with public test identifiers. Live provider
authorization requires registered applications and user consent and is not
covered by these fixtures.
The PonderSource Google OAuth project is pondersource-apps. It is in
production mode, available beyond named test users. Google verification is still
pending; users may see an unverified-app warning and the project has a lifetime
100-user cap until its requested scopes are approved. The published privacy
notice is https://pondersource.com/privacy.html.
The Dropbox app is PonderSource Apps (app key gaezgoax9khjilj), with
additional users enabled in development mode (up to 500 users).