Access data in Azure Cosmos DB using Mongoose with Azure Static Web Apps

Mongoose is the most popular ODM (Object Document Mapping) client for Node.js. Mongoose allows you to design a data structure and enforce validation, and provides all the tooling necessary to interact with databases that support the MongoDB API. Cosmos DB supports the necessary MongoDB APIs and is available as a back-end server option on Azure.


1. Create a Cosmos DB serverless database

Complete the following steps to create a Cosmos serverless DB.

  1. Sign in to the Azure portal.
  2. Select Create a resource.
  3. Enter Azure Cosmos DB in the search box.
  4. Select Azure Cosmos DB.
  5. Select Create.
  6. If prompted, under Azure Cosmos DB API for MongoDB select Create.
  7. Configure your Azure Cosmos DB Account with the following information:
    • Subscription: Choose the subscription you wish to use
    • Resource: Select Create new, and set the name to aswa-mongoose
    • Account name: A unique value is required
    • Location: West US 2
    • Capacity mode: Serverless (preview)
    • Version: 4.0 Screenshot showing form for creating new Cosmos DB instance.
  8. Select Review + create.
  9. Select Create.

The creation process takes a few minutes. We'll come back to the database to gather the connection string after we create a static web app.

2. Create a static web app

This tutorial uses a GitHub template repository to help you create your application.

  1. Go to the starter template.

  2. Choose the owner (if using an organization other than your main account).

  3. Name your repository aswa-mongoose-tutorial.

  4. Select Create repository from template.

  5. Return to the Azure portal.

  6. Select Create a resource.

  7. Enter static web app in the search box.

  8. Select Static Web App.

  9. Select Create.

  10. Configure your Azure Static Web App with the following information:

    • Subscription: Choose the same subscription as before
    • Resource group: Select aswa-mongoose
    • Name: aswa-mongoose-tutorial
    • Region: West US 2
    • Select Sign in with GitHub
    • Select Authorize if prompted to allow Azure Static Web Apps to create the GitHub Action to enable deployment
    • Organization: Your GitHub account name
    • Repository: aswa-mongoose-tutorial
    • Branch: main
    • Build presets: Choose React
    • App location: /
    • Api location: api
    • Output location: build Completed Azure Static Web Apps form
  11. Select Review and create.

  12. Select Create.

  13. The creation process takes a few moments; select Go to resource once the static web app is provisioned.

3. Configure database connection string

To allow the web app to communicate with the database, the database connection string is stored as an application setting. Setting values are accessible in Node.js using the process.env object.

  1. Select Home in the upper left corner of the Azure portal (or go back to
  2. Select Resource groups.
  3. Select aswa-mongoose.
  4. Select the name of your database account - it has a type of Azure Cosmos DB API for Mongo DB.
  5. Under Settings select Connection String.
  6. Copy the connection string listed under PRIMARY CONNECTION STRING.
  7. In the breadcrumbs, select aswa-mongoose.
  8. Select aswa-mongoose-tutorial to return to the website instance.
  9. Under Settings select Configuration.
  10. Select Add and create a new Application Setting with the following values:
    • Value: <Paste the connection string you copied earlier>
  11. Select OK.
  12. Select Add and create a new Application Setting with the following values for name of the database:
    • Value: todo
  13. Select OK.
  14. Select Save.

4. Go to your site

You can now explore the static web app.

  1. In the Azure portal, select Overview.
  2. Select the URL displayed in the upper right.
    1. It looks similar to
  3. Select Please login to see your list of tasks.
  4. Select Grant consent to access the application.
  5. Create a new list by entering a name into the textbox labeled create new list and selecting Save.
  6. Create a new task by typing in a title in the textbox labeled create new item and selecting Save.
  7. Confirm the task is displayed (it may take a moment).
  8. Mark the task as complete by selecting the check; the task moves to the Done items section of the page.
  9. Refresh the page to confirm a database is being used.

Clean up resources

If you're not going to continue to use this application, delete the resource group with the following steps:

  1. Return to the Azure portal.
  2. Select Resource groups.
  3. Select aswa-mongoose.
  4. Select Delete resource group.
  5. Enter aswa-mongoose into the textbox.
  6. Select Delete.

Next steps

Advance to the next article to learn how to configure local development...