https://github.com/thenickdude/serverless-nodejs-starter
https://github.com/thenickdude/serverless-nodejs-starter
Last synced: 2 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/thenickdude/serverless-nodejs-starter
- Owner: thenickdude
- License: mit
- Created: 2018-02-05T23:49:38.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2018-02-07T21:15:14.000Z (over 7 years ago)
- Last Synced: 2025-01-26T00:17:02.186Z (4 months ago)
- Language: JavaScript
- Size: 161 KB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Serverless Node.js Starter
A Serverless starter that adds ES7 async/await and unit test support. Part of the [Serverless Stack](http://serverless-stack.com) guide.
[Serverless Node.js Starter](https://github.com/AnomalyInnovations/serverless-nodejs-starter) uses the [serverless-webpack](https://github.com/serverless-heaven/serverless-webpack) plugin, [Babel](https://babeljs.io), and [Jest](https://facebook.github.io/jest/). It supports:
- **ES7 syntax in your handler functions**
- Use async/await
- And much more!
- **Support for unit tests**
- Run `npm test` to run your tests
- **Sourcemaps for proper error messages**
- Error message show the correct line numbers
- Works in production with CloudWatch
- **Automatic support for multiple handler files**
- No need to add a new entry to your `webpack.config.js`
If you'd like to learn how to setup your existing Serverless project to support ES7 async/await, use this [guide on Serverless-Stack.com](http://serverless-stack.com/chapters/add-support-for-es6-javascript.html).
---
### Demo
A demo version of this service is hosted on AWS - [`https://cvps1pt354.execute-api.us-east-1.amazonaws.com/dev/hello`](https://cvps1pt354.execute-api.us-east-1.amazonaws.com/dev/hello)
And here is the ES7 source behind it
``` javascript
export const hello = async (event, context, callback) => {
const response = {
statusCode: 200,
body: JSON.stringify({
message: `Go Serverless v1.0! ${(await message({ time: 1, copy: 'Your function executed successfully!'}))}`,
input: event,
}),
};
callback(null, response);
};
const message = ({ time, ...rest }) => new Promise((resolve, reject) =>
setTimeout(() => {
resolve(`${rest.copy} (with a delay)`);
}, time * 1000)
);
```
### Requirements
- [Install the Serverless Framework](https://serverless.com/framework/docs/providers/aws/guide/installation/)
- [Configure your AWS CLI](https://serverless.com/framework/docs/providers/aws/guide/credentials/)
### Installation
To create a new Serverless project with ES7 support.
``` bash
$ serverless install --url https://github.com/AnomalyInnovations/serverless-nodejs-starter --name my-project
```
Enter the new directory
``` bash
$ cd my-project
```
Install the Node.js packages
``` bash
$ npm install
```
### Usage
To run unit tests on your local
``` bash
$ npm test
```
To run a function on your local
``` bash
$ serverless invoke local --function hello
```
Run your tests
``` bash
$ npm test
```
We use Jest to run our tests. You can read more about setting up your tests [here](https://facebook.github.io/jest/docs/en/getting-started.html#content).
Deploy your project
``` bash
$ serverless deploy
```
Deploy a single function
``` bash
$ serverless deploy function --function hello
```
To add another function as a new file to your project, simply add the new file and add the reference to `serverless.yml`. The `webpack.config.js` automatically handles functions in different files.
### Support
- Send us an [email](mailto:[email protected]) if you have any questions
- Open a [new issue](https://github.com/AnomalyInnovations/serverless-nodejs-starter/issues/new) if you've found a bug or have some suggestions.
- Or submit a pull request!
### Maintainers
Serverless Node.js Starter is maintained by Frank Wang ([@fanjiewang](https://twitter.com/fanjiewang)) & Jay V ([@jayair](https://twitter.com/jayair)). [**Subscribe to our newsletter**](http://eepurl.com/cEaBlf) for updates. Send us an [email](mailto:[email protected]) if you have any questions.