QingZoneX Portal

Official portal and documentation site for QTable, QingZoneX's open-source, AI-native project and work management product.

QTable is one product implemented across two public repositories:

• QingZoneX/qtable-server — FastAPI / Strawberry GraphQL backend, domain services, permissions, automation, auditability, attachments, search, OAuth and AI services;
• QingZoneX/qtable-web — React web application for work centers, Grid / Kanban / Gantt / Calendar / Gallery, dashboards, collaboration, automation and AI workflows.

Repository names are engineering boundaries, not separate products. Portal copy, documentation and links must stay centered on the QTable product while identifying qtable-server and qtable-web precisely when source ownership matters.

The current source baseline is v0.1.1-alpha / Open Source Preview and both source repositories are public. A public source repository does not by itself imply that a GitHub Release or registry artifact has been published, so release documentation must keep source status and published artifacts distinct.

Stack

• Astro 7
• Starlight
• Static output for GitHub Pages
• Simplified Chinese, Traditional Chinese and English
• No runtime database or server dependency for the portal
• Vanilla JavaScript for the interactive product tour

Requirements

• Node.js 22.12 or newer
• npm 10 or newer

Local development

npm ci
npm run dev

Production verification

npm ci
npm run verify:config
npm run verify:source
npm run verify:i18n
npm run verify:links
npm run build
npm run verify:dist
npm run verify:transfer

verify:transfer performs a second Astro/Starlight production build using the canonical QingZoneX/qingzonex.github.io repository identity. It verifies root Pages paths, localized routes, internal links/assets, canonical origin and Starlight edit links.

GitHub Pages deployment

QingZoneX/qingzonex.github.io is the organization Pages repository and deploys from the root base / through GitHub Actions. A future custom domain can be configured with the SITE_URL Actions variable without rewriting application routes.

See DEPLOYMENT.md and LOCALIZATION.md.

Content contract

Portal claims are checked against the current qtable-server and qtable-web source, version files, release evidence and GitHub Issues while preserving the single-product QTable model.

When the implementation repositories change names, versions, runtime requirements or delivered capabilities, update all three locales together and keep source links canonical. Do not present roadmap items as shipped features, and do not present a source tag as a GitHub Release or other distribution artifact unless that artifact actually exists.

License

The source code and documentation in this repository are licensed under the Apache License, Version 2.0, unless otherwise noted.

See NOTICE for project attribution and brand-use information. Third-party software, dependencies, fonts, icons, images, and other assets remain subject to their respective licenses and attribution terms.

The Apache License 2.0 does not grant permission to use QingZoneX trade names, trademarks, service marks, product names, logos, or other brand assets except as permitted by Section 6 of the license and applicable law.