Shop at Home

The Shop at Home app allows customers to securely add, edit, view, and remove items such as food and household needs from their list.

This repository contains apps that can be used as a starting point for some MS Learn Modules. Because everyone has their own preference for JavaScript frameworks, you can choose which one best suits your needs.

• The frontend is built using 4 JavaScript frameworks (Angular 21, React 19, Svelte 5, Vue 3.5) and is deployed to Azure Static Web Apps
• The sample contains 2 APIs you can choose from: Azure Functions (v4 programming model) and a Fastify 5 server deployed to Azure Container Apps

Run Shop at Home locally

Prerequisites

• A GitHub account
• Node.js and Git
• Visual Studio Code installed
• The SWA CLI installed
• The Static Web Apps extension installed
• The Azure Functions Core Tools installed

See instructions to install, setup and run the application locally in the README.md file located at the root of the respective folders.

Deploy to Azure using Azure Static Web Apps (Azure Functions API)

1. Once you are signed in on Azure through the link above, select a subscription and resource group then:
   • Static Web App details: Provide a name and select a hosting plan
   • GitHub Login: Set your deployment source as GitHub then log in and fill in the required fields on the form:
     • Organization – Choose your organization.
     • Repository – Select the shop at home repository.
     • Branch - Select a branch (main)
     • Build Presets - Azure Static Web Apps uses a detection algorithm to detect the framework used and defaults to Svelte. (You can change to use your framework of choice and issue the App location, Api location - ./api and output location)
   • Deployment: Click 'Review + Create', then 'Create'
   • Post-Deployment: After deployment is complete, click on 'Go to Deployment' then 'View app in browser'.

Once your GitHub Action is executed successfully, refresh the live page to view your application.

Deploy to Azure using App Spaces (Fastify API)

1. Once you are signed in on Azure through the link above,

   • For New Users: Clicking the button above will take you to the App Space template gallery. Select a shopping app solution template based on your preferred framework.

   • For Existing Users: Clicking the button above will direct you to a page displaying your existing app spaces and a ‘Create App Space’ button. Click ‘Create App Space’ to access the template gallery and choose a shopping app solution template.

   • GitHub Login: Log in to your GitHub account and fill in your organization and other required fields on the form:

     • GitHub account – Connect to your GitHub Account.
     • Organization – Choose your organization.
     • New Repository – This will be automatically populated with a fork that's created on your account.
     • App Space name – Give your App Space a name (or use the default).
     • Subscription – Choose your subscription.
     • Region – Choose an Azure region.

   • Deployment: Click ‘Deploy’ to view the deployment progress.

   • Post-Deployment: After deployment is complete, you will be redirected to your app space for management.

   Since your frontend is already linked to the backend, to view your API, authentiate on the App through GitHub or Entra ID and the call will be securely proxied via /api/ path. Ie. Use the route /api/products to see product data

Learn how

Learn how to Publish an Angular, React, Svelte, or Vue JavaScript app and API with Azure Static Web Apps

Problems or Suggestions

Open an issue here

Learn More

• Learn how to set up local development for Azure Static Web Apps using SWA CLI

  • Learn more about SWA CLI

• Learn about Azure Static Web App

• Authenticate and authorize Static Web Apps

• Add an API to Azure Static Web Apps

• API support in Azure Static Web Apps

• Routes

• Review pre-production environments

• Learn about App Spaces

• Learn more about Azure Container Apps

• Azure Free Trial

Contributing

We welcome contributions! See CONTRIBUTING.md for guidelines.

Quick Start for Contributors

1. Fork and clone the repo
2. Install dependencies for the app you want to work on:

   cd <app-folder> && npm install
   

3. Build the app:

   cd angular-app && npx ng build
   cd react-app && npm run build      # Vite
   cd svelte-app && npm run build     # Vite
   cd vue-app && npm run build
   

4. Submit a pull request

For the full contributor and AI agent guide, see AGENTS.md.