Move Github'y files into the .github folder
This commit is contained in:
41
src/Umbraco.Web.UI.Client/.github/README.md
vendored
Normal file
41
src/Umbraco.Web.UI.Client/.github/README.md
vendored
Normal 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/).
|
||||
Reference in New Issue
Block a user