Skip to content
Clean Lambda Function
Lean Mean Clean Apps

Five templates, one brand, one search box. Everything in the docs is in here, including the bits we hoped you'd skim.

Try one of these

Results say which template they came from, so you won't end up reading about Lambda when you wanted GraphQL. Again.

Get started

By the end of this page you’ll have your own solution, a container running it, and a function that answers back. It takes about five minutes, or ten if Docker decides to download the internet first.

You need the .NET 10 SDK and Docker. You don’t need an AWS account yet. The container image ships with the Lambda runtime emulator, so your laptop can pretend to be AWS for a while.

  1. Install the template from NuGet.

    Terminal window
    dotnet new install CleanLambdaFunction.Template
  2. Create a solution. The name becomes your namespace, project names and folder, so pick something you’re happy to see a lot of.

    Terminal window
    dotnet new cleanlambdafunction --name WorksOnMyMachine.Movies --authorName "Your Name"
    cd WorksOnMyMachine.Movies

    Rather click? The template shows up in the new project dialog in Visual Studio and Rider with the same options. Fill them in properly. You never know who’s reading and handing out .NET Rocks mugs… Hi Richard!

    If the dialog asks for a solution format, pick .slnx, which is what the template makes. Some versions of Visual Studio and Rider still write a second solution file next to it. If you end up with two, open the .slnx and delete the other one.

  3. Have a look around. Everything you need is already here.

    • WorksOnMyMachine.Movies.slnx
    • Dockerfile
    • docker-compose.yml
    • Directorysrc/
      • DirectoryApplication/ the rules, queries and validation
        • …
      • DirectoryInfrastructure/ the database and repositories
        • …
      • DirectoryPresentation/ the Lambda handler
        • …
    • Directorytests/
      • DirectoryApplication.Tests.Unit/
        • …
      • DirectoryInfrastructure.Tests.Integration/
        • …
      • DirectoryPresentation.Tests.Integration/
        • …
      • DirectoryPresentation.Tests.Unit/
        • …
  4. Build the image and start it with sample data. Docker Compose turns the sample data on for you.

    Terminal window
    docker compose up -d --build
  5. Invoke the function. The emulator listens on port 7350 and answers the same way Lambda does.

    Terminal window
    curl -X POST "http://localhost:7350/2015-03-31/functions/function/invocations" \
    -d '{"query":"space","limit":2}'

    You get a page of movies back:

    {
    "items": [
    { "id": "cb188ef6-14e7-f85f-2f78-924c2ab26b28", "title": "Deep Space Gardeners", "reviewCount": 5, "averageStars": 3.4 },
    { "id": "dfefa450-5454-6a4d-a4aa-95a9b047c17b", "title": "Postcards from Outer Space", "reviewCount": 1, "averageStars": 3 }
    ],
    "totalCount": 4,
    "nextOffset": 2
    }

    The sample movies are all made up. Deep Space Gardeners averages 3.4 stars from five reviews, which seems fair for a film about weeding in zero gravity.

  6. Run the tests while you’re here.

    Terminal window
    dotnet test
  7. Tidy up when you’re done.

    Terminal window
    docker compose down

Hit a snag? Check Troubleshooting.