← Back to App Hub
πŸ”

How App Hub actually works

Full transparency β€” in plain English, with the real technical details underneath.
The one-sentence version: every app is just a web page that your browser saves onto your device, and everything you create is stored in your browser's own private storage on that same device β€” nothing is ever uploaded to us or anyone else, because there is no server to upload to.
Installing Working offline Where your data lives Encryption What leaves your device Updates Moving & backing up Removing an app Security measures Verify it yourself

1 How an app gets onto your device

App Hub is a collection of Progressive Web Apps (PWAs). A PWA is a normal website that a modern browser can also install like an app. There is no app store, no download of an .exe or .apk, and nothing to approve beyond your browser's own "Add to Home Screen" prompt.

Step 1
You open an app
You visit the app's page in your browser, just like any website.
Step 2
You choose "Install"
Use the Install button, or your browser's "Add to Home Screen" / "Install app" menu item.
Step 3
The browser saves it
Your browser copies the app's files into its own local cache and adds an icon to your home screen or desktop.
Step 4
It opens full-screen
Tapping the icon launches the app in its own window β€” no address bar, like a native app.

Each app is a single self-contained page plus a small icon set and a helper file called a service worker (more on that next). A tiny file called a manifest (manifest.webmanifest) tells your device the app's name, icon and that it should open full-screen. That's the entire "installer."

Nothing runs with special privileges. An installed PWA has exactly the same limited permissions as a web page. It cannot read your files, your other apps, or anything on your device that you don't explicitly hand to it through a file picker.

2 Why it keeps working offline

When you first open an app, its service worker β€” a small script the browser runs in the background β€” saves a copy of the app's files (the page, styles, scripts and icons) into a private on-device store called the Cache Storage. After that, opening the app loads those saved files directly from your device instead of the network.

3 Where your information is stored

Everything you create β€” notes, passwords, spreadsheets, designs, 3D models, plans, custody records β€” is saved in your browser's own storage on the same device you're using. We never see it because it never leaves your machine. The specific storage mechanisms:

localStorageA per-site key–value store built into every browser. Most apps keep your documents and settings here. It's private to this site and to your device β€” other websites can't read it.
Cache StorageHolds the app's own files so it works offline (see above). Managed by the service worker.
In-memory onlySome sensitive values (like a Vault's unlocked encryption key) live only in the page's memory while it's open and vanish the instant you lock it or close the tab.
Files you exportWhen you press Export, Save or Download, the file is written to your device's Downloads folder by your browser β€” you choose where it goes.

Storage is sandboxed per origin. Every app on this site shares the same origin (this website), so they can share small conveniences like your light/dark preference β€” but no other website anywhere can reach into this storage, and these apps can't reach into any other site's storage either. That boundary is enforced by the browser itself.

4 How the sensitive apps encrypt your data

Apps that hold secrets β€” Vault (passwords) and locked notes in Notes β€” encrypt your data before it's written to storage, using your browser's built-in Web Crypto engine. The plain, readable version never touches the disk.

CipherAES-GCM with 256-bit keys β€” a modern, authenticated encryption standard. "Authenticated" means tampering is detected, not just hidden.
Key from your passwordYour master password is stretched into an encryption key with PBKDF2 using 210,000 rounds of SHA-256 and a random per-vault salt. This makes password-guessing attacks extremely slow.
Fresh randomness every timeEvery single encryption uses a brand-new random 12-byte value (an "IV"), so re-saving the same data never produces a reusable pattern.
Recovery keyVault also wraps your data key with a random recovery key file you save at setup. If you forget your master password, that file lets you set a new one β€” without it or the password, the data is unrecoverable, even by us.
What's storedOnly the encrypted blob. Titles, notes, one-time-code secrets β€” all of it is inside the ciphertext. There is no plaintext copy anywhere.
We could not read your Vault even if we wanted to. The key is derived from a password only you know and is never sent anywhere. This is the same category of encryption used by banks and password managers β€” running entirely inside your browser.

5 What leaves your device answer: nothing

Once an app's files are cached, it makes no network requests at all in normal use. To be concrete, here's what is not present anywhere in this project:

The only time your browser talks to the network is when you deliberately open or update an app (fetching its files from this site), or click an external link you chose to click (for example a map link). Even those links are set to send no referrer information. Your browser also enforces a strict Content-Security-Policy on every page that blocks all connections to any other server β€” so even in the unlikely event of a bug, your data has nowhere external to go.

6 How updates reach you

When we improve an app, the service worker notices the new version the next time you open it, quietly downloads the updated files, and swaps them in. The Hub shows a small "updated β€” refresh" note when a new version is ready. You never install anything manually, and an update can only ever replace the app's program files β€” it never touches the data you've created.

7 Moving to a new device & backups

Because your data lives on one device, apps that hold important data include an Export / backup button that writes everything to a single file you control:

You are always in control of the transfer. The file goes where you send it β€” we're never in the middle.

8 Removing an app or wiping your data

9 Security measures we've put in place

Beyond "we don't collect anything," the apps are hardened so that a malicious file or link can't be used to attack you:

10 Don't take our word for it β€” verify

You can confirm all of this yourself: