- Run
npm install
- Run
npm run dev
to launch Vite in dev mode
The development environment supports .env
files, so in order to set your own make a copy
of .env
and name it .env.local
and set the variables you need.
As an example to show the installer instead of the login screen, set the following
in the .env.local
file to indicate that Umbraco has not been installed:
VITE_UMBRACO_INSTALL_STATUS=must-install
The development environment is the default environment and is used when running npm run dev
. All API calls are mocked and the Umbraco backoffice is served from the src
folder.
Note Make sure you have followed the Authentication guide before continuing.
If you have a local Umbraco instance running, you can use the development environment to run against it by overriding the API URL and bypassing the mock-service-worker in the frontend client.
Create a .env.local
file and set the following variables:
VITE_UMBRACO_API_URL=https://localhost:44339 # This will be the URL to your Umbraco instance
VITE_UMBRACO_USE_MSW=off # Indicate that you want all API calls to bypass MSW (mock-service-worker)
See the Main branch in action here as an Azure Static Web App. The deploy runs automatically every time the main
branch is updated. It uses mocked responses from the Umbraco API to simulate the site just like the local development environment.
Storybook is also being built and deployed automatically on the Main branch, including a preview URL on each pull request. See it in action on this Azure Static Web App.
We accept contributions to this project. However be aware that we are mainly working on a private backlog, so not everyone will be immediately obvious. If you want to get started on contributing, please read the contribute space where you will be able to find the guidelines on how to contribute as well as a list of good first issues.