TurboWarp

Repeat the three previous sets of commands every time you pull changes from GitHub. Once you have everything compiled and fetched, you are ready to package it up for Electron. For development, start a development Electron instance with: In Linux, The app icon won't work in the development version, but it will work in the packaged version. We've found that development can work pretty well if you open two terminals side-by-side and run npm run webpack:watch in one and npm run electron:start in the other. You can refresh the windows with ctrl+R or cmd+R for renderer file changes to apply, and manually restart the app for main file changes to apply. On some Linux distributions, Electron will crash with the message The SUID sandbox helper binary was found, but is not configured correctly. Rather than run without sandboxing I'm aborting now. You need to make sure that /home/.../turbowarp-desktop/node modules/electron/dist/chrome-sandbox is owned by root and has mode 4755. . Notably we have seen this happen on Debian 10 and earlier and Ubuntu 24.04 and later. There are ways to make this permanent, but we don't think you should be making permanent kernel configuration changes just to develop this app. This error won't happen in the final .deb package, Flathub, or Snap Store releases. The development version of the app will be larger and slower than the final release builds. Then to package up the final Electron binaries, use either our build script release-automation/build.mjs (see release-automation/README.md) or the electron-builder CLI. Either way the final builds are saved in the dist folder. Here are some examples using the electron-builder CLI directly: You can typically only package for a certain operating system while on that operating system. TurboWarp Desktop uses a free code signing provided by SignPath.io, certificate by SignPath Foundation. TurboWarp Desktop lets you configure custom JS and CSS without rebuilding the app. Find TurboWarp Desktop's data path by using the list below or by clicking "?" in the top right corner, then "Desktop Settings", then "Open User Data", then opening the highlighted folder, or refer to this list: Windows (except Microsoft Store): %APPDATA%/turbowarp-desktop Microsoft Store: Open %LOCALAPPDATA%/Packages , find the folder with the word TurboWarpDesktop in it, then open LocalCache/Roaming/turbowarp-desktop macOS (except Mac App Store): ~/Library/Application Support/turbowarp-desktop Mac App Store: ~/Library/Containers/org.turbowarp.desktop/Data/Library/Application Support/turbowarp-desktop (note that the org.turbowarp.desktop part may appear as TurboWarp in Finder) Linux (except Flatpak and Snap): ~/.config/turbowarp-desktop Linux (Flatpak): ~/.var/app/org.turbowarp.TurboWarp/config/turbowarp-desktop Linux (Snap): ~/snap/turbowarp-desktop/current/.config/turbowarp-desktop Create the file userscript.js in this folder to configure custom JS. Create the file userstyle.css in this folder to configure custom CSS. Completely restart TurboWarp Desktop (including all windows) to apply.