Files
SRCmail/vnc/VNC-CHANGES.md
T
Bernd RodlerandClaude Opus 4.8 0189935e7b feat(mf): join VNClagoon Suite microfrontends group
Wrap next.config with withMicrofrontends; add @vercel/microfrontends.
Served at /mail under the suite shell (via NEXT_PUBLIC_BASE_PATH set on the
Vercel project). Logged in vnc/VNC-CHANGES.md.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-08-03 16:04:40 +02:00

29 lines
1.5 KiB
Markdown

# VNC-CHANGES — VNCmail+ divergence log
VNCmail+ is a fork of [bulwarkmail/webmail](https://github.com/bulwarkmail/webmail)
(AGPL-3.0). This file records **every** intentional divergence from upstream so
that merging new upstream releases stays a triage exercise, not an archaeology dig.
## Rules of the fork
1. **Keep upstream files unmodified whenever possible.** Prefer env vars
(branding), the `vnc/overrides/` layer, and additive files over editing files
inside `app/`, `components/`, `lib/`, `stores/`.
2. **Every edit to an upstream file gets a one-line entry below** — path, what,
why. No silent edits.
3. **Branches:** `main` tracks upstream releases (kept clean); `dev` is the VNC
integration + Vercel deploy branch; `vnc/*` are feature branches.
4. **Syncing upstream:** `git fetch upstream && git merge upstream/main` onto
`main`, then merge `main` into `dev`. Resolve using this log.
## Divergences
| Date | File / area | Change | Why |
|------|-------------|--------|-----|
| 2026-08-03 | `vnc/` (new) | Added VNC customization dir + this log | Fork bootstrap |
| 2026-08-03 | `VNCMAIL-SETUP.md` (new) | Vercel deploy runbook | Deploy on Vercel as project "VNCmail+" |
| 2026-08-03 | `next.config.ts` | Wrap export with `withMicrofrontends(...)` + import | Join VNClagoon Suite microfrontends group (served at /mail) |
| 2026-08-03 | `package.json` | Add `@vercel/microfrontends` dep | Microfrontends child integration |
_(append new rows as you diverge)_