Skip to content
/ nx-serverless Public template

Modern Serverless framework starter template using Nrwl Nx monorepo dev toolkit

License

Notifications You must be signed in to change notification settings

sudokar/nx-serverless

Repository files navigation

nx-serverless-monorepo

serverless esbuild npm peer dependency version (scoped) code style: prettier GitHub license Percentage of issues still open PRs Welcome Maintained

TypeScript GitHub Actions

A monrepo style, modern boilerplate or template project for Serverless framework using Nx monorepo toolkit 🛠 and aws-nodejs-typescript serverless template

Table of contents

Whats Included

  • A template project layout using latest version of Nx and Servrless framework
  • An easy to use workspace generator to generate a template/stack with Serverless framework files and related Nx configuration
  • Configured with AWS provider and it can be easily adopted to any cloud provider

Template Layout

.
├── stacks/    # stack for each serverless configuration/template and its associated files
├── libs/      # shared libraries
├── tools/
├── README.md
├── jest.config.js
├── jest.preset.js
├── nx.json
├── package.json
├── serverless.base.ts  # base configuration for serverless
├── tsconfig.base.json
├── workspace.json
├── .editorconfig
├── .eslintrc.json
├── .gitignore
├── .husky              # git hooks
├── .nvmrc
├── .prettierignore
├── .prettierrc

Prerequisites

  • Nodejs protip: use nvm

    ⚠️ Version: lts/iron (v20). If you're using nvm, run nvm use to ensure you're using the same Node version in local and in your lambda's runtime.

  • 📦 Package Manager

  • 💅 Code format plugins

    On your preferred code editor, Install plugins for the above list of tools

Usage

Depending on your prefrered package manager, follow the instructions below to build and deploy serverless stack(s).

  • Install project dependencies

    yarn install
  • Generate a new stack

    nx g serverless <STACK_NAME>

    Run with -d or --dry-run flag for dry run

  • Generate a new library

    nx g @nx/node:lib --skipBabelrc --tags lib <LIBRARY_NAME>

    Run with -d or --dry-run flag for dry run

  • Package stack

    • To package single stack

      nx run <STACK_NAME>:build --stage=<STAGE_NAME>
    • To package stack affected by a change

      nx affected:build --stage=<STAGE_NAME>
    • To package all stacks

      nx run-many --target=build --stage=<STAGE_NAME>
  • Deploy stack to cloud

    • To deploy single stack

      nx run <STACK_NAME>:deploy --stage=<STAGE_NAME>
    • To deploy stack affected by a change

      nx affected:deploy --stage=<STAGE_NAME>
    • To deploy all stacks

      nx run-many --target=deploy --all --stage=<STAGE_NAME>
  • Remove stack from cloud

    • To remove single stack

      nx run <STACK_NAME>:remove --stage=<STAGE_NAME>
    • To remove stack affected by a change

      nx affected:remove --stage=<STAGE_NAME>
    • To remove all stacks

      nx run-many --target=remove --all --stage=<STAGE_NAME>
  • Run tests

    • To run tests in single stack

      nx run <STACK_NAME>:test --stage=<STAGE_NAME>
    • To run tests affected by a change

      nx affected:test --stage=<STAGE_NAME>
    • To run tests in all stacks

      nx run-many --target=test --all --stage=<STAGE_NAME>
  • Run offline / locally

    • To run offlline, configure serverless-offline plugin as documented here and run below command

      nx run <STACK_NAME>:serve --stage=<STAGE_NAME>
  • Understand your workspace

    nx dep-graph
    

Further help

Nx Cloud

Computation Memoization in the Cloud

​ Nx Cloud pairs with Nx in order to enable you to build and test code more rapidly, by up to 10 times.

​ Visit Nx Cloud to learn more and enable it

Contribution

Found an issue? feel free to raise an issue with information to reproduce.

Pull requests are welcome to improve.

Support

Like the template?

Click to Buy Me A Coffee

Or, Add a star ⭐ to the repository

Maintainer

This template is authored and maintained by sudokar

License

MIT