README.md

LocalStack Samples

Sample applications that run on LocalStack, the local cloud development platform. Each sample deploys a real architecture to the LocalStack emulators for AWS, Snowflake or Azure, on your machine or in CI, with no cloud account. Most samples also include a CI workflow that deploys the app and tests it on every pull request.

Run a sample

1. Install the lstk CLI and log in:

   brew install localstack/tap/lstk   # or: npm install -g @localstack/lstk
   lstk login                         # or: export LOCALSTACK_AUTH_TOKEN=<your-token>

2. Start the emulator the sample needs:

   lstk start                     # AWS
   lstk start --type snowflake    # Snowflake
   lstk start --type azure        # Azure

3. Clone a sample and follow its README to deploy and test it.

Browse all repositories, check the CI status of every sample, or find samples by service in the docs.

Contributing

Found a broken sample or want a new one? Open an issue in the sample's repository, or read the contributing guide to add your own. Everyone taking part is expected to follow our Code of Conduct.

Found a bug in LocalStack itself? Start a discussion in the LocalStack community. For questions, join the LocalStack Community Slack.