[](https://codeclimate.com/github/maciejtreder/ng-toolkit/maintainability)
[](https://codeclimate.com/github/maciejtreder/ng-toolkit/test_coverage)
[](https://travis-ci.org/maciejtreder/ng-toolkit)
[](https://david-dm.org/maciejtreder/ng-toolkit)
[](#backers)
[](#sponsors)
[](https://badge.fury.io/js/%40ng-toolkit%2Fserverless)
# Serverless support for your Angular application [](https://twitter.com/intent/tweet?text=Just%20started%20using%20@ng-toolkit/serverless&url=https://github.com/maciejtreder/ng-toolkit&via=maciejtreder&hashtags=angular,pwa,webapp,software,developers,serverless,firebase)
### _**Star it and share with others!**_
_This is part of the @ng-toolkit project. [Check main page for more tools](https://github.com/maciejtreder/ng-toolkit)_
Add serverless support (AWS Lambda; Google Cloud Functions & Firebase) to your Angular project. Supports as well client-side-only projects as Angular Universal projects (server side rendering).
[Check deep overview article on Medium](https://medium.com/@maciejtreder/angular-serverless-a713e86ea07a)
## Live demo
[Angular Universal PWA on AWS Lambda + API Gateway](https://www.angular-toolkit.maciejtreder.com)
## Content
- [Getting started](#start)
- [Options](#options)
- [Question, Problem, Feature Request](#question)
- [Support @ng-toolkit](#funding)
## Getting started
Create or navigate into your project:
```bash
ng new myApp
cd myApp
```
### AWS Lambda & Google Cloud Functions
```
ng add @ng-toolkit/serverless --provider aws
```
Deploy to "maintenance link" (non customized - ie: https://123456.execute-api.eu-central-1.amazonaws.com/production)
```
npm run build:serverless:deploy
```
Deploy to customized link (example.com):
```
npm run build:prod:deploy
```
You can read more about [using custom domain in AWS Lambda in this Medium post](https://medium.com/@maciejtreder/custom-domain-in-aws-api-gateway-a2b7feaf9c74) or [in the official AWS documentation](https://docs.aws.amazon.com/apigateway/latest/developerguide/how-to-custom-domains.html).
### Firebase
```
ng add @ng-toolkit/serverless --provider firebase --firebaseProject [your_project_ID]
npm run build:prod:deploy
```
Project ID, can be found in project settings:
You can chain this package with:
- [@ng-toolkit/universal](https://github.com/maciejtreder/ng-toolkit/blob/master/schematics/universal)
- [@ng-toolkit/pwa](https://github.com/maciejtreder/ng-toolkit/blob/master/schematics/pwa)
- [@ng-toolkit/firebug](https://github.com/maciejtreder/ng-toolkit/blob/master/schematics/firebug)
## Options
This schematic supports several options in order to fit your needs.
| name | type | default | description |
|-----------------|---------|---------|---------------------------------------------------------------|
| provider | string | 'aws' | Specify serverless provider. |
| skipInstall | boolean | false | Skip installation of dependencies. |
| directory | string | '.' | The directory name to create the workspace in. |
| firebaseProject | string | | Firebase project id. |
| lambdaTS | boolean | false | Generate lambda files using Typescript instead of Javascript. |
| offline | boolean | false | Include serverless-offline package for local development. |
## Looking for something more?
Feel free to [create issue with your feature request](https://github.com/maciejtreder/angular-toolkit/issues/new)
## Support @ng-toolkit/serverless
You can support development of this project via:
- [Open Collective](https://opencollective.com/ng-toolkit)
- [Donorbox](https://donorbox.org/ng-toolkit)
- [Liberapay](https://liberapay.com/maciejtreder/donate)
- [Paypal](https://www.paypal.me/ngtoolkit)
If you want, you can be listed on the [List of donors](https://www.angular-universal-pwa.maciejtreder.com/donors) on the demo page.
### Open Collective Backers
Support this project with a monthly donation and help us continue our activities. [[Become a backer](https://opencollective.com/ng-toolkit#backer)]
### Open Collective Sponsors
Become a sponsor and get your logo on our README on GitHub with a link to your site. [[Become a sponsor](https://opencollective.com/ng-toolkit#sponsor)]
## Credentials
* Checkout my [home page](https://www.maciejtreder.com) and find out more about me