Developer Notes

Minimal repo-working notes for agents and contributors.

Core commands

npm install
npm run dev

The Vite dev server binds to 127.0.0.1:5173 by default. To expose it on your LAN:

HOST=0.0.0.0 npm run dev

Run both test suites after code changes: npm test and npm run test:e2e
Playwright starts the app server from playwright.config.ts; do not manually start another dev server unless you are intentionally reusing one
If Chromium is missing, run npx playwright install chromium
In sandboxed environments, e2e may need permission to open a local listening port

Dependabot checks npm, GitHub Actions, and Docker dependencies weekly on Monday at 09:00 America/Winnipeg
Treat patch/minor dependency PRs as routine maintenance; merge them when CI is green
Review semver-major dependency PRs as planned batches, not mixed with unrelated feature work
Handle critical/high audit findings within a few days; moderate/low findings can wait for the monthly maintenance pass
Avoid routine npm audit fix --force; inspect breaking changes first

Monthly maintenance pass:

git pull --ff-only
npm outdated
npm audit
npm test
npm run build
npm run test:e2e

Use the local proxy when working on WebDAV sync:

NEXTCLOUD_URL=https://your-nextcloud.com/remote.php/webdav npm run dev:proxy

Or run the app and proxy together:

NEXTCLOUD_URL=https://your-nextcloud.com/remote.php/webdav npm run dev:all

When using the dev proxy, set the proxy URL in the app to http://localhost:3001.

The About modal version comes from package.json
Do not manually bump package.json for normal work
semantic-release handles releases from commits on main
Use Conventional Commits: feat: for minor, fix: or perf: for patch, and ! or BREAKING CHANGE: for major