Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Install as an app and work offline

This chapter covers installing CivilKit CAD as an app in its own window, using it without a network, how updates arrive, and what the app keeps on your device.

CivilKit CAD runs in the browser. After the first visit it can also start without a network, because the app files are saved on your device. Installing it is optional and only changes how it looks and starts.

Install it

Browsers that support installing a site offer it once the site qualifies (it is served over https and has its app files saved). When the app is installable, an Install button appears in the top bar. Its tooltip reads “Install CivilKit CAD as an app: its own window, and it opens without the browser.”

  1. Choose Install in the top bar.
  2. Confirm in the browser’s own install dialog.
  3. CivilKit CAD opens in its own window, and it gets an icon you can start from like any other app.

Per platform:

  • Chrome and Edge (desktop): use the Install button, or the install icon at the right end of the address bar. Once installed, double-clicking a .ckpart file can open it in the app (choose CivilKit CAD under Open with).
  • Android (Chrome): open the browser menu and choose Install app (or Add to Home screen).
  • Safari on Mac: choose File, Add to Dock.
  • Safari on iPhone and iPad: tap Share, then Add to Home Screen. There is no Install button in the top bar on these.
  • Firefox (desktop): does not install sites as apps; the app still works offline in a tab.

Notes:

  • The button shows only in browsers that offer installation, and only while the app is not already installed. If you do not see it, look for an install option in your browser’s menu or address bar.
  • Some browsers do not send the install offer the Install button depends on. There, use the browser’s own menu if it has an install or add-to-home-screen option.
  • The installed app has the name “CivilKit CAD” and runs in a standalone window without the browser’s address bar.
  • Uninstall it from your browser’s app list or your system’s app list. Your saved parts are files on your computer and are not removed.

Work offline

The first time you open the app with a network, it saves the app files on your device: the page, the program, the geometry kernel and the icons. After that:

  • The app starts without a network. If you open the page address with no connection, the saved copy loads.
  • Everything that runs in the browser works: sketching, modelling, saving to your computer, importing and exporting files.
  • Samples you opened before are available. A sample you have never opened is fetched when you first pick it, so it needs a network the first time.
  • Library parts are available offline only after you installed them or dropped them once. See The library and samples.
  • The local kernel service and the MCP server work on your own computer and do not need the internet either. See The local kernel service.

On a phone or tablet the geometry kernel (about 7 MB) is not saved when the app is installed, so the first load stays light; it is saved the first time the app starts the kernel, which happens as soon as you open or build a part. Open a part once while online before you rely on offline use there.

To be sure it works offline, open the app once while online and wait for it to finish loading.

Updates

When a new version is published:

  • The app checks about every five minutes, and whenever you return to its tab. If it finds a newer version, a notice appears in the top bar: “A new version (0.6.5) is available.” with Reload and Later (without the number if it cannot be read). Settings > About > Check for updates looks right away and shows the time of the last check.
  • Automatic. An installed app on an iPad is usually suspended, not closed, so it can sit on an old version for weeks. When you open it again (or it starts) and a newer version is out, the app reloads by itself and shows “Updated to 0.7.2” for a moment. It does this only when nothing is unsaved, no sketch, feature editor, wizard or dialog is open, and you have not touched the screen yet; in any other case you get the notice below and nothing reloads under your hands. After more than a minute in the background the check does not wait for the five-minute interval. Turn it off in Settings > General > Update automatically to always get the notice.
  • Reload reloads the app. If your part has unsaved changes, the app asks first what to do with them. Later dismisses the notice for now.
  • Without a network, the check quietly waits until the next try.
  • On the next load the app fetches the page from the network first and falls back to the saved copy. A deployed update is therefore picked up on your next online visit. The program files themselves have fixed names tied to their content, so an old copy never mixes with a new one. Older saved copies are removed automatically.

Files saved by earlier versions still open in newer ones.

What is stored on your device

All of this stays in your browser’s storage for this site. The app has no account and no cloud storage. Your parts go to a file only when you save.

WhatWhereWhy
App files and the geometry kernelBrowser cacheStarting offline and starting quickly.
Autosave of the open partLocal storageRestoring your work after a crash or a closed tab. Documents over about 3 MB of text are not autosaved.
Rolling snapshots of the open partBrowser databaseUp to ten earlier states, taken at most every 30 seconds while you work, for Recover earlier versions….
A saved picture of the model’s viewBrowser databaseShows a part before the kernel has rebuilt it. It is a cache and is rebuilt when stale.
Recent files and samples (names and thumbnails)Local storageThe recent list in the Library picker.
Workspace settings, theme, language, navigation and sketch preferencesLocal storageRemembered between visits.
Libraries you added, installed library parts and licence confirmationsLocal storage and browser databaseSee The library and samples.
Local kernel service address and access tokenLocal storageOnly if you use the service.

Saving a part with Save or Save as writes a file to your computer. In browsers that support direct file access, Save can overwrite the same file. Otherwise the browser downloads a new copy each time. See Saving and opening.

Clearing it

Clear this site’s data in your browser’s settings to remove everything above, including settings, libraries and the saved app files. That does not touch files you saved on your computer. Browsers may also clear a site’s storage on their own when disk space runs low, or after a long time without a visit. Save your work to files, and do not rely on autosave or snapshots as the only copy.

Private or incognito windows may block storage. The app still runs, but your settings and autosave last only for that session.

Next