AWS SES Template Manager GUI

Features

A simple productivity tool presenting a user interface around the AWS SES command line interface. This application allows for quick and easy reviewing, creating, updating and deleting of AWS SES templates within any region.

Other useful features include:

• SES template duplication.
• Syntax highlighting for the HTML body of your emails.
• Merge variables into the HTML body of your emails.
• Live Preview of the HTML body of your emails.
• S3 image uploads, served using CDN public URLs (set up Amazon CloudFront distribution with the S3 bucket as the origin).
• Send test emails for your template including adding values for any replacement tags you may have implemented.
• Be notified of any newer versions of this application to always ensure you have the latest features.

See installation instructions to get started.

Motivation

AWS currently only allows CRUD actions on SES templates via the command line. Performing these actions especially for multiple templates can be time consuming and in some cases inefficient depending the volumes of templates you're managing. A simple GUI application allowing the user to quickly perform these actions without need to run multiple CLI commands can be more efficient in some cases.

Screenshots

Review templates per region:

Create/Update template:

Tech / framework used

• AdonisJS
• Bootstrap 4

Installation

• Ensure to have setup your AWS credentials on your machine.
• git clone this project repo.
• npm install
• Ensure 'AWS_PROFILE_NAME' within the .env file is set to your desired aws named profile. Also ensure for the named profile chosen that all applicable permissions are granted to allow for creating, retrieving, updating, deleting and sending SES templates.
• adonis serve --dev will run the application.

Docker installation

Run the following command to run the docker image:

docker run -p 3333:3333 \
  -e AWS_ACCESS_KEY_ID=<your-aws-access-key-id> \
  -e AWS_SECRET_ACCESS_KEY=<your-aws-secret-access-key> \
  -e AWS_REGION=<your-aws-region> \
  -e AWS_S3_BUCKET_NAME=<your-aws-s3-bucket-name> \
  -e IMAGES_CDN_URL_PREFIX=<your-images-cdn-url-prefix>/ \
  ghcr.io/rayyansys/aws-ses-template-manager:latest

You can use the latest version of the image or pull a specific release tag. Browse tags from the packages section on the right.

How to use

Once installation steps have been followed, navigate to http://127.0.0.1:3333 (host and port can be changed via the .env file if required).

The index page will show a table of existing SES templates in your selected region using the AWS named profile specified in the .env file. You can further go ahead and either delete or edit an SES template from this same table.

Staying up to date

The application will automatically check to see if you are using the latest release version. If you are not, then you will get a visual prompt to let you know there is a newer version of the app available (as shown above in the top left). This is a great way to stay up to date with new features etc.

You can easily get the latest changes by:

• running the command: git pull
• stop and restarting adonis (adonis serve --dev)
• closing and re-opening your local browser tab

You can click on the 'new version available' button to access the newer versions release notes. Some updates may include additional dependencies. In which case npm install is advised in the release notes.

Contribute

Pull requests are very much welcomed.

License

Modified MIT @ Matthew Ruddick