Move Github'y files into the .github folder

This commit is contained in:
Warren Buckley
2023-01-26 14:17:43 +01:00
parent cace73d7d5
commit 4f08b67499
3 changed files with 0 additions and 0 deletions

View File

@@ -0,0 +1,41 @@
# Umbraco.CMS.Backoffice
## Installation instructions
1. Run `npm install`
2. Run `npm run dev` to launch Vite in dev mode
### Environment variables
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:
```bash
VITE_UMBRACO_INSTALL_STATUS=must-install
```
## Environments
### Development
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.
### Run against a local Umbraco instance
Create a `.env.local` file and set the following variables:
```bash
VITE_UMBRACO_API_URL=http://localhost:5000 # 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)
```
### Static website
See the Main branch in action here as an [Azure Static Web App](https://ashy-bay-09f36a803.1.azurestaticapps.net/). 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
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](https://ambitious-stone-0033b3603.1.azurestaticapps.net/).