yv01p/Umbraco-CMS
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: Add 'Running Umbraco in Different Modes' section to copilot-instructions

Browse Source
This commit is contained in:
Jacob Overgaard
2025-10-21 16:22:36 +02:00
parent daace4b4a0
commit 942ccc82d9
1 changed files with 16 additions and 5 deletions
Download Patch File Download Diff File Expand all files Collapse all files

21
.github/copilot-instructions.md vendored
View File

@@ -94,11 +94,18 @@ The solution contains 30 C# projects organized as follows:
## Common Tasks ## Common Tasks
### Frontend Development ### Running Umbraco in Different Modes
For frontend-only changes:
1. Configure backend for frontend development: **Production Mode (Standard Development)**
```json Use this for backend development, testing full builds, or when you don't need hot reloading:
<!-- Add to src/Umbraco.Web.UI/appsettings.json under Umbraco:Cms:Security: --> 1. Build frontend assets: `cd src/Umbraco.Web.UI.Client && npm run build:for:cms`
2. Run backend: `cd src/Umbraco.Web.UI && dotnet run --no-build`
3. Access backoffice: `https://localhost:44339/umbraco`
4. Application uses compiled frontend from `wwwroot/umbraco/backoffice/`
**Vite Dev Server Mode (Frontend Development with Hot Reload)**
Use this for frontend-only development with hot module reloading:
1. Configure backend for frontend development - Add to `src/Umbraco.Web.UI/appsettings.json` under `Umbraco:CMS:Security`:
```json ```json
"BackOfficeHost": "http://localhost:5173", "BackOfficeHost": "http://localhost:5173",
"AuthorizeCallbackPathName": "/oauth_complete", "AuthorizeCallbackPathName": "/oauth_complete",
@@ -107,6 +114,10 @@ For frontend-only changes:
``` ```
2. Run backend: `cd src/Umbraco.Web.UI && dotnet run --no-build` 2. Run backend: `cd src/Umbraco.Web.UI && dotnet run --no-build`
3. Run frontend dev server: `cd src/Umbraco.Web.UI.Client && npm run dev:server` 3. Run frontend dev server: `cd src/Umbraco.Web.UI.Client && npm run dev:server`
4. Access backoffice: `http://localhost:5173/` (no `/umbraco` prefix)
5. Changes to TypeScript/Lit files hot reload automatically
**Important:** Remove the `BackOfficeHost` configuration before committing or switching back to production mode.
### Backend-Only Development ### Backend-Only Development
For backend-only changes, disable frontend builds: For backend-only changes, disable frontend builds: