mattruddick / aws-ses-template-manager

A simple application offering an interface for CRUD management of AWS SES templates across all compatible regions and with your own choice of credentials profile. A great GUI productivity tool that can be setup and run locally in seconds (see readme).

AWS SES Template Manager GUI

Status: Maintained

This proof of concept application precedes https://seslium.com. It is still maintained to provide fixes for any bugs which are raised.

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.
• 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.

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.

License

Modified MIT @ Matthew Ruddick

aws-ses-template-manager's Issues

Templates without TextPart crash the getTemplate call

I was working with a template that didn't have a TextPart (created outside of this application via cli). Trying to edit it resulted in a 500 error from the local server. I was able to patch it locally by simply adding an if(TextPart) to this line:

aws-ses-template-manager/app/Controllers/Http/SesTemplateController.js

Line 102 in bdc0b9f

dynamicFieldsArr = [...dynamicFieldsArr, ...this.getDynamicFields(TextPart)]; // TextPart

Not an issue- packaged into a Docker container, FYI

Source at https://github.com/initialed85/docker-aws-ses-template-manager

Published Docker image at https://hub.docker.com/r/initialed85/aws-ses-template-manager

[Update Template] Submit button remains disabled

When attempting to update an existing template.
The submit button of the page does not switch itself to enabled even after modifying the fields.

The workaround I have used so far is to remove the disabled attribute from template-form.edge or directly remove via browser inspector.

TextArea for Text Content

Hello,

Thanks for the nice tool. :)
Would you change the plain text's input to a multiple lines textarea for instead?

Update button not always enabled

The "update" button is not always clickable, even after making some edits in the HTML template. I think the button could be always enabled anyways, as updating without changes would still work. I have this problem regularly and need to open the developer tools and remove the disabled attribute manually to fix it

Option to supply template data as JSON when testing template.

Rather than having to fill in individual fields, it would be helpful to be able to supply raw JSON for the template data when testing a template. My template has quite a number of fields, some of them nested.