{"id":19370074,"url":"https://github.com/bustle/sammie","last_synced_at":"2025-04-23T15:31:51.749Z","repository":{"id":53478628,"uuid":"117704239","full_name":"bustle/sammie","owner":"bustle","description":"Serverless Application Model Made Infinitely Easier","archived":false,"fork":false,"pushed_at":"2021-03-29T16:33:44.000Z","size":296,"stargazers_count":21,"open_issues_count":1,"forks_count":1,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-04-02T17:11:15.200Z","etag":null,"topics":["api-gateway","aws","cloudformation","lambda","sam","sam-template","serverless","serverless-applications"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bustle.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2018-01-16T15:47:36.000Z","updated_at":"2023-02-07T22:21:13.000Z","dependencies_parsed_at":"2022-08-19T15:31:28.136Z","dependency_job_id":null,"html_url":"https://github.com/bustle/sammie","commit_stats":null,"previous_names":[],"tags_count":12,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bustle%2Fsammie","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bustle%2Fsammie/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bustle%2Fsammie/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bustle%2Fsammie/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bustle","download_url":"https://codeload.github.com/bustle/sammie/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250460492,"owners_count":21434256,"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":["api-gateway","aws","cloudformation","lambda","sam","sam-template","serverless","serverless-applications"],"created_at":"2024-11-10T08:14:09.586Z","updated_at":"2025-04-23T15:31:51.470Z","avatar_url":"https://github.com/bustle.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"## SAMMIE - Serverless Application Model Made Infinitely Easier\n\n[AWS's Serverless Application Model (SAM)](https://github.com/awslabs/serverless-application-model) is the official AWS provided way to define serverless applications. sammie's purpose is to get you set up and deployed in seconds _using SAM_.\n\n### Features\n\n- Generate a minimal yet flexible SAM template for you to get started.\n- Simplify SAM's complex packaging \u0026 deploy steps \u0026 flags into a simple `deploy` command.\n- Provide a best practice for deploying multiple environments.\n\n---\n\n### Prerequisites\n\n[AWS CLI](https://aws.amazon.com/cli/) - sammie uses this for all AWS operations under the hood.\n\n### Quickstart\n\n```bash\nnpm i sammie -g\nsammie init my-app\nsammie deploy\n```\n\nThis will generate a serverless application, deploy it to a development environment, and direct you to your app served over https!\n\n---\n\n### Commands\n\n#### init - Generates a serverless application including a SAM template \u0026 lambda function\n\n`sammie init \u003cname\u003e`  \n_Options:_  \n`-y, --yaml`: Generate yaml for SAM template. Defaults to json, because javascript.\n\n#### deploy - Deploys application\n\n`sammie deploy`  \n_Options:_  \n`-t, --template`: Path to a SAM template. Defaults to `sam.(json|yaml)` in the current directory.  \n`-e, --environment`: An environment name to deploy. Defaults to \"development\".  \n`-p, --parameters`: A list of parameters to override in your template.  \n`-s, --stack-name`: Option to override the auto-generated environment stack name.  \n`--s3-bucket`: S3 bucket where code is uploaded. Defaults to Parameters.bucketName in template which is generated for you.  \n`--s3-prefix`: S3 path prefix added to the packaged code file. Defaults to stackName/year.\n\n---\n\n### Environments\n\nIt's a best practice to create completely separate stacks for each of your application's environments, rather than a single stack with multiple lambda qualifiers, API Gateway stages, and permissions. This makes your application more portable and reduces the blast radius of taking down your live application during the development cycle.\n\nTo support this, sammie will deploy separate stacks for you based on the environment option:\n\nE.g. your stack name is \"my-app\":  \n`sammie deploy` will deploy stack \"my-app-development\" (development is the default)  \n`sammie deploy --environment production` will deploy stack \"my-app-production\"\n\n#### Environment variables \u0026 properties\n\nTo help add environment specific variables \u0026 properties, you can create separate SAM templates named with the environment suffix.  \nE.g. `sam-production.json` containing the following, will get _merged with your base template_ `sam.json` upon `sammie deploy --environment production`\n\n```json\n{\n  \"Resources\": {\n    \"TestFunction\": {\n      \"Properties\": {\n        \"MemorySize\": 1280,\n        \"Environment\": {\n          \"Variables\": {\n            \"ENV_VAR1\": \"var1-prod\",\n            \"ENV_VAR2\": \"var2-prod\"\n          }\n        }\n      }\n    }\n  }\n}\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbustle%2Fsammie","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbustle%2Fsammie","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbustle%2Fsammie/lists"}