Skip to content

SailAway is a command-line tool for Sailthru that enables easy access to some UI functions through the command line. It also includes features such as synced code and shorthand commands for sending emails to regular addresses.

Notifications You must be signed in to change notification settings

Colin-Whelan/SailAway

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

60 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Streamline your coding journey with SailAway ⛵

A command line tool for SailThru

Version

Enables local code development with live code syncing and email shorthands for quick testing.

Features

SailAway brings development of SailThru templates back to your local coding environment. Gone are the days of manually/downloading uploading code in SailThru or using the online editor. Use all the dev tools you are used to and let SailAway handle syncing the code to SailThru.

Live Syncing

When code is pushed or pulled you will have the option to sync the code to the SailThru server every time the file is saved. This lets you work on HTML + Zephyr code with all the setup and the tools you are used to without having to manually upload each time.

Bulk Template Download and Upload (WIP)

Download all templates from an environment, or upload an entire folder's worth of emails to another. Bulk upload requires that all from and reply-to email addresses are already set up in the environment.

WARNING: Be VERY careful with this. This will can/will overwrite all local templates, and all templates in the selected environment. Be very careful!

Email Shorthands

When sending tests, you can also configure email shorthands instead of typing addresses. To update the shorthands, edit the config.js file in the root directory. Shorthands and email addresses can be mixed in the recipients list.

What emails to send to? (separate by comma) » example@gmail.com, me, test, etc

Github Copilot

If Github Copilot is enabled, working locally is even better. Copilot is able to assist in writing the Zephyr code for SailThru, but has limited success so always check the outputs.

Install

Download the repo and run the following command in the root directory:

npm install

Setup

Create a .env file in the root directory with the following variables:

SAILTHRU_API_KEY=your_api_key
SAILTHRU_API_SECRET=your_api_secret

For different SailThru environment, you can create a .env file for each. For example: dev.env and then in the command line you can specify the environment with --env=dev.

If no environment is specified, it will use the settings in the .env file.

Usage

node sail [--env=dev]

This will start the CLI and you will be prompted to select an option.

Send SailThru Test

This will prompt for recipients and a choice from a list of all templates in the SailThru account. It will then send a test to each recipient entered. The recipients can be a comma separated list of emails and shorthands.

Pull SailThru Code

This will show a list of all templates in the SailThru account. Select the template you want to pull and it will be saved to the /templates directory.

Note: if the template already exists in the /templates directory, it will be overwritten.

Push Local Code

This will show a list of all templates in the /templates directory. Select the template you want to push and it will be uploaded to the SailThru account.

If the template already exists in the SailThru account, there will be a prompt to confirm the overwrite of the existing template.

Author

👤 Colin Whelan

Show your support

Give a ⭐️ if this project helped you!

About

SailAway is a command-line tool for Sailthru that enables easy access to some UI functions through the command line. It also includes features such as synced code and shorthand commands for sending emails to regular addresses.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published