rtynski/Hy2026
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs(readme): document dev ports, TLS certs and default proxy

Browse Source
This commit is contained in:
Rafał Tyński
2026-10-04 05:42:48 +02:00
parent 69af054774
commit c23fa95640
1 changed files with 14 additions and 4 deletions
Download Patch File Download Diff File Expand all files Collapse all files
README.md
+14 -4
View File
@@ -19,24 +19,34 @@ Platforma Małopolskiego Hubu Innowacji Społecznych (MVP hackathonu).
Windows nie kojarzy domyślnie plików `.ps1`, dlatego skrypty uruchamiaj przez
`pwsh` (np. `pwsh ./scripts/docker-push.ps1`), a nie przez dwuklik / samo
`./scripts/docker-push.ps1`. Instalacja: https://aka.ms/powershell
(PowerShell 7.6.6: https://github.com/powershell/powershell/releases#release-v7.6.6)
## Praca lokalna
Backend (dev) nasłuchuje na `https://localhost:7080`.
Backend (dev) domyślnie nasłuchuje na `http://localhost:5078` (profil `http`), a opcjonalnie na `https://localhost:7080` (profil `https`). Dev-serwer Vite działa po HTTPS na `https://localhost:7081` i przekierowuje `/api` do backendu (`http://localhost:5078`).
Certyfikat HTTPS dla Vite pochodzi z `dotnet dev-certs` — wygeneruj go raz (wymaga `pwsh`):
```pwsh
# terminal 1 — backend
pwsh ./scripts/dev-certs.ps1 # lub: npm --prefix client run certs
```
```pwsh
# terminal 1 — backend (profil http, port 5078)
dotnet run --project backend
# terminal 2 — client (Vite, proxy /api -> http://localhost:5078)
# terminal 2 — client (Vite, https://localhost:7081, proxy /api -> http://localhost:5078)
npm --prefix client install
npm --prefix client run dev
```
Aby użyć profilu `https` backendu (port 7080), uruchom `dotnet run --project backend --launch-profile https` i zmień `proxy.target` w `client/vite.config.ts` na `https://localhost:7080`. Domyślna konfiguracja nie wymaga żadnych zmiennych środowiskowych.
## Skrypty
```pwsh
npm --prefix client run dev # uruchamia Vite (dev server)
npm --prefix client run dev # uruchamia Vite (dev server, HTTPS :7081)
npm --prefix client run certs # eksport certyfikatu dev do client/.certs (dotnet dev-certs)
npm --prefix client run build # buduje aplikację Vite do client/dist
npm --prefix client run copy # kopiuje client/dist -> backend/wwwroot
node scripts/build.mjs # buduje całość (client + copy + backend)