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.
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.
Review templates per region:
Create/Update template:
- AdonisJS
- Bootstrap 4
- 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.
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.
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.
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.
Pull requests are very much welcomed.