{"id":19763602,"url":"https://github.com/yerinadler/typescript-serverless-boilerplate","last_synced_at":"2026-05-18T05:39:39.797Z","repository":{"id":48811270,"uuid":"384751816","full_name":"yerinadler/typescript-serverless-boilerplate","owner":"yerinadler","description":"A Typescript boilerplate with Ioc Container for Serverless framework","archived":false,"fork":false,"pushed_at":"2022-10-22T03:58:59.000Z","size":284,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-01-10T23:45:09.547Z","etag":null,"topics":["aws","aws-lambda","lambda","serverless","typescript"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/yerinadler.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2021-07-10T17:15:36.000Z","updated_at":"2022-10-22T03:59:03.000Z","dependencies_parsed_at":"2023-01-20T09:47:57.415Z","dependency_job_id":null,"html_url":"https://github.com/yerinadler/typescript-serverless-boilerplate","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yerinadler%2Ftypescript-serverless-boilerplate","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yerinadler%2Ftypescript-serverless-boilerplate/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yerinadler%2Ftypescript-serverless-boilerplate/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yerinadler%2Ftypescript-serverless-boilerplate/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/yerinadler","download_url":"https://codeload.github.com/yerinadler/typescript-serverless-boilerplate/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":241095912,"owners_count":19908888,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["aws","aws-lambda","lambda","serverless","typescript"],"created_at":"2024-11-12T04:10:08.557Z","updated_at":"2026-05-18T05:39:34.758Z","avatar_url":"https://github.com/yerinadler.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# TypeScript Serverless Boilerplate\nA TypeScript boilerplate designed for AWS Lambda via Serverless framework\n\n## Description\nThe boilerplate comes with 2 functions that can be used as an example. One for GET request and another one for POST request. The latter incorporates Middy as a middleware to validate the request body\n\n## Setup\nMake sure you have `NodeJS 14` or later installed along with `npm` or `yarn`. And follow below steps to get started.\n\nYou also need `serverless` command to be available which could be accomplished using below command\n\n```bash\n# With yarn\nyarn global add serverless\n# With npm\nnpm install -g serverless\n```\n\nThen perform the below steps to spin up the local development environment\n\n1. Copy the `.env_example` into `.env` file for managing environment variables for local development or create one your own\n2. Run `yarn` or `npm install` to install dependencies\n3. Run the command `yarn start:dev` to start the local development server (via serverless-offline plugin)\n\n## Packages \u0026 Dependencies\n| Tool        | Library     | Version |\n| ----------- | ----------- | ------- |\n| IoC Container| Inversify | 5.1.1+ |\n| Environment Management | serverless-dotenv-plugin | 3.9.0+ |\n| Middleware | Middy | 2.4.3+ |\n| Local Development | serverless-offline | 7.0.0+ |\n| Test Runner | Jest | 27.0.6+ |\n| Code Bundler | Webpack | 5.44.0+ |\n| Linter | EsLint | 7.30.0+ |\n\n## Project Structure\nThe project code is primarily stored in the `src` folder except some of the setup files e.g. Jest config, Webpack config, EsLine config, etc.\n\nThe Lambda handlers are in the `interfaces/handlers` directory along with `middlewares` and other `utils`\n\nThe overall project structure is shown below\n````\n├── src\n│   ├── services\n│   ├── data\n│   ├── interfaces\n│   │   ├── handlers\n│   │   ├── middlewares\n│   │   └── utils\n│   ├── configuration.ts\n│   ├── inversify.config.ts\n│   └── types.ts\n├── jest.config.js\n├── jest.setup.ts\n├── package.json\n├── serverless.yml\n├── tsconfig.json\n├── webpack.config.js\n````\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyerinadler%2Ftypescript-serverless-boilerplate","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fyerinadler%2Ftypescript-serverless-boilerplate","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyerinadler%2Ftypescript-serverless-boilerplate/lists"}