The command-line interface for developing and managing building blocks for the next generation of Volusion storefronts
After installing Node.js, run
npm install -g @volusion/element-cli
The command for logging into the Element ecosystem. This is necessary for publishing and updating blocks.
Use the same credentials you use to log into your Volusion store admin.
The command for scaffolding a new block. The command will clone the Element Block Starter repo, allowing you to quickly get started with your development process.
You can use the optional --git
flag to let git handle your block commits and major versions.
From the root directory of the block you intend to eventually make available to users of the Site Designer on the Volusion store admin.
Publishing your first block also will create a v1 branch to manage the version code base.
By default, newly-published blocks will only be visible to you and the other members of your organization.
In the event that a -c/--category
flag is not passed, you will be prompted with a list of valid Category names from which to select.
If you pass -m or --new-major
it will create a new major version for the block and a corresponding git branch.
Protip: element publish -n "A NAME TO DISPLAY TO USERS" -c "OPTIONAL CATEGORY"
Protip: element publish -m
After you make changes to your block, and are ready test to them in the Site Designer, run this command from the root directory of the block. You'll likely run this command often.
There's only one optional flag for this command, and it's to make your initially-private block public, and available in the world.
Protip: element update -p
When you are ready to push your block live you can use this command.
There's only one optional flag for this command, and it's to add a release note to your block
Protip: element update -n "release note for the block"
If you have a problem with a release you can rollback to a previous release. The current release will be moved back to staging and the previous release will become active. If you rollback again it will remove the release from staging. You can continue to rollback until you only have your original release.
Each major version can be rolled back individually. However, you won't be able to rollback the inital published major version of the block.
Create a PNG file, ideally less than 100 kb in size, and save it in the root directory of the block as thumbnail.png.
When publishing or updating your block, this file will be saved and then be shown in the Volusion store admin's Site Designer.
element --help
# Or for individual commands, e.g.
element publish --help
Please see the DEVELOPING document for more information on the project requirements and workflow.
- Commander - User interaction framework 🖼
- Inquirer - Hidden fields 🙈 and fancy selections 💅
- Axios - Making calls across the network ☎️
- Mermaid - Building the diagrams 🧜♀️ 🧜♂️
We're very excited that you're interested in contributing! At present, we are working toward formalizing a process for providing feedback on and accepting pull requests. If you would like us to prioritize this process, please vote on this open issue with a 👍 . We do already have a Code of Conduct in place.
Our Code of Conduct, by way of the Contributor Covenant, can be found here.
© 2018 onward by Volusion MIT License