README
Sam-typescript-bootstrap
This is a CLI npm package for creating a simple AWS Serverless project using the SAM. The package will ask a series of questions and generate the required files and configuration that makes up a project with the following features:
- Typescript to JS transpiling, using webpack to create a
dist
folder containing the JS source code for the project to be deployed. - Unit testing library (Mocha/Chai/Sinon OR Jest) and sample unit test file setup.
- Cloudformation template provisioning a simple lambda
- Simple API Swagger documentation for the simple lambda that is created
Using the package
Installing the package globally
npm i -g sam-typescript-bootstrap
Run the sam-bootstrap
command to start the CLI package, follow the instructions and the files will be generated in the directory that the CLI package was started in.
Once the files are generated, it is important to install the packages:
npm i
Then build the bootstrap files for the example lambda:
npm run build:local
Once the the build is complete run the following command to start the application:
npm run start:local
At this point you should be able to test the lambda is running correctly by performing a GET to the local endpoint that the lambda is running on, which will be displayed on the CLI.
For example:
GET: http://127.0.0.1:3000/test
Will return a 200 response:
{
"message": "OK"
}
Notes/Todo
- Add ability to generate a simple frontend react-create-app project using AWS SAM
- Clean up the source code of this project, as it is still a WIP.
- Add custom domain for API.
- Automation tests (using cucumber)
Any suggestions on features/improvements are welcome.