Files
FileHost/docs-site/en/guide/local-dev.md
T
O96u 737235acff
ci / ci (22, ubuntu-latest) (push) Canceled after 0s
GitHub Release / release (push) Canceled after 0s
Publish Docker image / build (linux/amd64, ubuntu-latest, amd64) (push) Canceled after 0s
Publish Docker image / build (linux/arm64, ubuntu-24.04-arm, arm64) (push) Canceled after 0s
Publish Docker image / merge (push) Canceled after 0s
release: v1.4.0 — 标签系统、操作日志扩展与文档截图更新
- 每用户标签与彩色打标,图库 OR/AND 筛选与批量打标
- 操作日志记录登录、删除、设置与标签操作
- API 标签/打标接口;README 与文档站截图同步
2026-09-09 14:46:52 +08:00

1.6 KiB

Local development

Full-stack Nuxt 4 development at the repository root. Data defaults to ./data.

Requirements

  • Node.js 22
  • npm 11 (see packageManager in package.json)

Start

npm install
cp .env.example .env   # optional
npm run dev

Open http://localhost:3000/setup to create the admin account. Data directory defaults to ./data (DATA_DIR overrides).

Common commands

Command Description
npm run dev Dev server
npm run build Production build
npm run start Run .output
npm run lint ESLint
npm run typecheck Type check
npm test Unit tests
npm run reset-password Reset password (optional username)
npm run slider Reset login verification to local slider
npm run clear-domains Clear site/image URL settings from DB (recover from dual-domain lockout)

Dev-only variables

Variable Description
DEV_BYPASS_ACCESS true bypasses login (skips /setup; rarely needed)
DATA_DIR Data directory, default ./data

Full list: Environment variables.

Dual-domain local test

Edit hosts and follow Dual-domain separation for local verification.

Documentation site

npm run docs:dev
npm run docs:build
npm run docs:preview

Sources live in docs-site/; screenshot sources are in docs/screenshots/ (including upload.png, gallery.png, tags.png, api.png, storage.png, settings.png, logs.png, setup.png, etc.), copied to docs-site/public/screenshots/ before build. Live docs: https://o96u.github.io/PicHost/