essbee
v1.0.2
Published
storyblok wrapper cli POC
Downloads
1
Readme
🐍 essbee 🐝
A CLI tool for Storyblok. Built specifically to help with the migration of components from one space to another.
Installation
This CLI tool is designed to be able to be used from anywhere on your machine. To install it, you can run the following command to install it globally:
npm i essbee -g
Or you can clone the repo and install it globally using the following command:
npm install -g
Usage
This is a CLI tool that can be run from the terminal regardless of directory. To run the tool, simply type the following command in the terminal:
essbee
This tool assumes that you have a Storyblok account and have access to the spaces you are trying to migrate components from and to. It also assumes that you already have the storyblok-cli working on your machine, (i.e. installed and authed through SSO by providing your PAT from Storyblok.)
However if you don't have the CLI installed this wrapper will check and install it for you if you wish. This tool will also check if you are authed and if not will prompt you to do so using by providing your PAT from Storyblok.
greet
This is the initial message that will be displayed when you run the CLI tool. I love a little bit of ASCII art, so I have included a message to greet you.
cliCheck
This is the check to see if the CLI is installed.
If it is not, it will prompt you to install it.
If it is, if will show a success message of ✔ Storyblok CLI found.
.
authCheck
This is the check to see if you are authed with the storyblok-cli
.
If you are not, it will prompt you to auth using your PAT.
If you are, if will show a success message of ✔ Storyblok user logged in as: [email protected]
.
runCommand
This is the inquirer.js handler for what operation you would like to run. the options are:
pull components
This will pull all components from the source space you specify (either dev or prod), and save them optionally to one large or separate JSON files.
These files will be saved to the ~/Desktop/temp_storyblok_cli
directory at a subdirectory of <space>_<date-timestamp>
, e.g. dev_10-05-2024_12-00-00
.
push components
This will push selected components from the source directory you specify, to the target space you specify (either dev or prod).
pull and push content
This is a Todo, as it isn't core functionality we care about right now. But will be a feature in the future.
clean up temp directory
This will help you clean up the temp files that are created when pulling components.
Limitations
At the moment, this tool will prompt you to build up your request by following the UI. In future, I may build out functionaly to allow you to pass in flags to the initial command to skip the UI and go straight to the migration process.
This was built as a POC, and therefore has not been tested on all possible scenarios. If you find a bug, please raise an PR or talk to me (Fearne).
Security
This tool does not store any of your data. It simply wraps the Storyblok CLI to make requests to the Storyblok API on your behalf, in a slightly more user-friendly way.