A quick perusal of this blog shows how much I love Azure Static Web Apps, a wonderful service for hosting full-stack web applications. Static Web Apps uses Azure Functions for server-side code, and provides wonderful functionality including authentication.
When it comes time to start doing local development, the initial setup can require a couple of steps as there’s a fair bit being provided to you by the service. I want to explore how to setup a project for Azure Static Web Apps. I’m going to use Svelte, my current favorite front-end framework, but the steps are similar to any other framework you may choose.
Install Azure Functions Core Tools
Azure Functions is the serverless offering from Azure. By using Azure Functions Core Tools, you can run the service locally on your system for development. The docs show how to install Azure Functions Core Tools. I personally use Windows Subsystem for Linux (WSL) for all my development. I was able to install by opening a terminal for WSL (Ubuntu in my case) and running the NPM command:
npm i -g azure-functions-core-tools@3 --unsafe-perm true
Bootstrap the project
It seems every front-end framework has its own bootstrapping tool. Svelte is no different. To create the project we’ll use degit and the template provided by Svelte. In a terminal window, execute the following:
npx degit sveltejs/template svelte-static-web-apps cd svelte-static-web-apps npm install
Create the API
With the front-end project created, let’s create the back-end. We’ll do this by using
func, which is the command-line tool for managing Azure Functions, and was installed with the core tools. The two commands we’ll use are
func init to create the project, and
func new to create a new Azure Function. While we won’t use the function, I want to at least demo the process.
Typically, Azure Functions are stored in a folder named api. To create the folder and project, run the following in the same terminal window.
func init api
To create the first function, run the following:
cd api func new
Select HTTP trigger (option 10) for the template, and specify sample for the name of the trigger.
You have now setup Azure Functions for the project.
Add Azure Static Web Apps CLI
As highlighted earlier, Static Web Apps includes some neat functionality including authentication. If you are going to develop for the platform you’ll very likely want to take advantage of this. In addition, because the server-side is running in Azure Functions, local development can be a little trickier because of how the services will run on your system. Fortunately Azure Static Web Apps CLI will manage all of this for us, including giving us a great utility to mock the authentication process.
You can install it as a dev dependency using npm:
npm install --save-dev @azure/static-web-apps-cli
Update the start script
Finally we’ll need to update the dev script. Traditionally dev or start scripts launch the project for development purposes. We’re going to update the dev script to start everything we need - Svelte’s dev server, our Azure Function, and Azure Static Web Apps to tie everything together.
Open the project directory in Visual Studio Code by returning to the terminal window and running the following commands:
cd .. # To return to the root folder of the project code .
Inside Visual Studio Code, open package.json. Replace the dev script with the following:
"dev": "rollup -c -w & swa start http://localhost:5000 --api ./api",
Save the file, and your project is now ready to go!
Run the project
With everything setup, the last thing to do is run the project! Inside of Visual Studio Code, you can open a terminal window by selecting Terminal > New Terminal. In the newly opened terminal, run the following to start the server:
npm run dev