A Local add on for backing up sites to a personal storage platform. This repository hosts the source code; if you simply want to use the add-on, download the latest version of local from the release page and install the add-on within the app.
This add-on leverages restic and rclone to manage backup snapshots on a variety of storage platforms.
If you haven't already, it is advised that you familiarize yourself with the basics of electron.
Git LFS is used in this repository to manage large binary files (restic and rclone binaries).
brew updatebrew install git-lfsgit lfs install
Important Note! After installing LFS, run git lfs pull in local-addon-backups to ensure that all of the LFS binaries are properly pulled.
Clone the repository into one of the following directories depending on your platform:
- macOS:
~/Library/Application Support/Local/addons - Windows:
C:\Users\username\AppData\Roaming\Local\addons - Linux:
~/.config/Local/addons
You need to replace 'Local' with 'Local Beta' in the above paths if you want to create the add-on for Local Beta.
If you prefer to clone your source code elsewhere, you can do so and then symlink that directory to one in the above mentioned directories.
An example of this on MacOS would look like:
git clone [email protected]:getflywheel/local-addon-backups.git ~/code
ln -s ~/code/local-addon-backups ~/Library/Application Support/Local/addons
yarn install
This add-on utilizes tsc to compile the add-on.
yarn build
- Clone repo directly into the add-ons folder (paths described above)
yarn installornpm install(install dependencies)yarn buildornpm run build- Open Local and enable add-on
If the enabling the add-on via the Local UI doesn't work for some reason, you can also enable it by updating the file enabled-addons.json. This is located at one of the following application specific paths.
You'll want to make sure that the json file includes:
"@getflywheel/local-addon-backups": true
- macOS:
~/Library/Application Support/Local/enabled-addons.json - Linux:
~/.config/Local/enabled-addons.json - Windows:
C:\Users\<username>\AppData\Roaming\Local\addons/enabled-addons.json
- @getflywheel/local provides type definitions for Local's Add-on API.
- Node Module: https://www.npmjs.com/package/@getflywheel/local-components
- GitHub Repo: https://github.com/getflywheel/local-components
It is worth noting the the TS definitions for this module are exposed and publicly availble. The actual code is injected once the add-on is loaded by Local. This can make writing tests a little tricky as the @getflywheel/local/<main/renderer> module isn't available outside of Local (ie testing unit testing environments). The best option is to mock out this module while running tests.
- @getflywheel/local-components provides reusable React components to use in your Local add-on.
- Node Module: https://www.npmjs.com/package/@getflywheel/local
- GitHub Repo: https://github.com/getflywheel/local-addon-api
- Style Guide: https://getflywheel.github.io/local-components
All files (other than test files) in /src will be transpiled to /lib using TypeScript. Anything in /lib will be overwritten.
vendor contains compiled binaries namespaced under the appropriate operating system name. We only include 64 bit builds for OSX & Linux. Both 64 and 32 bit builds are included for Windows.
If you are looking for help getting started, you can consult the documentation for the add-on generator.
You can consult the Local add-on API, which provides a wide range of values and functions for developing your add-on.
MIT