BUILD.en.md

Build, verify, and release

This guide covers local builds of Intertwine-Ai-Image-Enhanced and the checks expected before publishing a release.

Prerequisites

• Node.js 18+ and npm
• Python 3.11+
• Python dependencies from backend/requirements.txt
• A local-only backend/.env file (never commit it)

Install and build

npm install
npm run build

The frontend output is written to dist/. It is reproducible build output and should not be committed.

Verification

python -m compileall backend/app
python -m unittest discover backend/tests
npm run lint:check
npm run build

Run

Use start.bat on Windows or ./start.sh on Linux/macOS. The production shape serves the built frontend and API from one Python port.

Release checklist

1. Confirm the build was produced from the intended commit.
2. Confirm .env files, API keys, runtime data, logs, caches, dist/, and local release archives are absent from the commit.
3. Back up the backend data directory and authentication state separately.
4. If a modified version is offered as a network service, provide the corresponding source code as required by section 13 of AGPL-3.0-or-later.