QFlow Author is an open-source environment for creating, reviewing, importing, and exporting assessments. It supports question banks, immutable question revisions, and QTI assessment packages.
Use Author independently or connect it to QFlow Deliver. The QTI library provides the reusable standards implementation.
Use Node 26.13.1 and pnpm 12.21.0. Install PostgreSQL 17, mkcert, and xmllint. For native HTTPS,
trust your mkcert CA once with mkcert -install.
pnpm install --frozen-lockfile
cp .env.example .env.local
# Configure DATABASE_URL for your local PostgreSQL instance.
pnpm setup:local
pnpm run doctor
pnpm devOpen https://127.0.0.1:5173. Create a local account and use onboarding for demo content. Stop the foreground server with Ctrl+C.
The app uses Cloudflare Workers locally through workerd. Local bindings are emulated; external
services require explicitly configured credentials. Setup prepares qflow_local and guarded
qflow_test databases without resetting existing data or changing privileges.
A Dev Container is also available. See local development and the configuration reference.
Hono handles HTTP routes; Preact renders pages and hydrates interactive islands. PostgreSQL and Drizzle store assessment data. R2 stores media; Workflows coordinate durable jobs. The shared QTI packages handle assessment standards; learner delivery belongs to a separate application.
Cloudflare runtime entrypoints under deploy/cloudflare/ are application code. This repository
includes generic configuration and isolated test/local settings, without production account settings
or deployment automation.
pnpm typecheck
pnpm lint
pnpm format:check
pnpm test
pnpm buildTests use the guarded local database. Install browser support with pnpm exec playwright install chromium. Run pnpm verify for the full matrix.
Oxlint checks JavaScript and TypeScript; dprint formats source files. Python is optional and confined to the Respondus fixture generator.
See CONTRIBUTING.md. Report vulnerabilities privately through the repository’s Security → Report a vulnerability form.
Licensed under the GNU Affero General Public License v3 (AGPL v3). See LICENSE. Third-party components retain their own license notices.