When doing rapid development or prototyping of an app, it can be time consuming to upload via the Dev Admin portal. Instead, you can use our CLI Ruby Gem that streamlines this process. The gem zips and uploads your files to Weebly, and installs the app to your Developer test Site. You can use this gem with your development process, so that anytime you update files, you trigger an upload of your updates to Weebly.
Install the Gem
You can install using RubyGems (recommended) or manually.
- Install RubyGems. You can follow the installation instructions on the official RubyGems Installation page (Windows users, please be sure to download the correct Ruby installer for your system from the official Ruby download page, as well as the appropriate development kit).
- Download the Weebly Bundler gem from our GitHub page to a directory named weeblybundler.
To install using RubyGems
Navigate to the directory where you have downloaded the gem and enter:
gem install weeblybundler
To manually install:
Download the source code:
git clone git@github:Weebly/weeblybundler.git
Change to the
weeblybundlerdirectory and install dependencies, including the Weebly Bundler.
- Run the following from the
weeblybundlerdirectory to install the gem to your gemset.
Use the Gem to Upload an App
When you use the bundler, if your app is still in a draft state and you upload without changing the version, the new zip is automatically installed to your developer test site and the previous version is overwritten. If you change the version, then previous versions are retained but you’ll need to install it manually to your site.
- If not already done, register your app.
- Make sure that your
client_idis set in the app’s manifest.
secretas environment variables. This is how the gem will know the correct site to install the app to. These values are shown on the app’s management page in the Dev Admin portal.
export WEEBLY_CLIENT_ID=client_id && export WEEBLY_SECRET=secret
To use the gem to upload an app:
Run the following, where
/Path/To/Element/Directory is the path to where your app’s zip file is located on your machine:
weeblybundle app /Path/To/Element/Directory
Rapid Prototype with the Gem
To get the most out of the Weebly Platform, we recommend using the
--watch flag that monitors a directory and runs the gem automatically.
To use the flag, run the following:
weeblybundle app /Path/To/Element/Directory --watch
Anytime you change a file in that directory, the gem runs: the files are zipped and that zip file is uploaded to your site. Refresh your browser to view the updated app or theme in Weebly.
If you’ve updated the version in the manifest, you’ll need to install the new version to the site from the Dev Admin portal. If the version hasn’t changed, the changes are automatically added to the editor, you just need to refresh to see the changes.