Projects
0 0 activeCreate your account
Get started with QtMesh Cloud.
Welcome back
Sign in to your QtMesh Cloud account.
Uses GitHub OAuth and links account automatically.
Overview
Monitor scan quality, badges, and project health in one place.
Scans (30d)
0 0 this weekWarnings
0 0 this weekErrors
0 0 this weekQuality Score
—Recent scans across your projects (newest on the right).
Recent Scans
No scans yet.
Projects
No projects yet.
Issues by Rule
No issues yet.
Integrate
Use our GitHub Action to run scans automatically in CI.
API
Upload scans and retrieve summaries through the REST API.
Badges
Show quality status in your README with dynamic SVG badges.
Selected project
Select a project to inspect recent scans.
What you get
- A unique ingest token for
POST /v1/ingest/scan - Per-project scan history, quality score (0–100), and asset metrics
- Shields-style SVG badges for READMEs
Create a project from the sidebar (optionally pick a GitHub repo). Open a row on the Dashboard or here to copy badge markdown and the ingest URL.
Your projects
Pipeline
- Run scans in GitHub Actions or your CI and POST the JSON payload to the ingest endpoint.
- The API derives status (pass / warning / fail), quality score, and mesh-related metrics from the payload.
- Raw reports can be stored in R2; metadata and history live in D1 for fast dashboards and badges.
Quality score
Score penalizes errors and warnings per scanned file, normalized to a 0–100 scale (same formula as the score badge). Hover points on the Dashboard quality chart for per-scan details.
Recent activity
No scans yet.
Available badges
Replace <slug> with your project slug. Base URL:
.../badges/qtmesh-status.svg— pass / warning / fail.../badges/qtmesh-score.svg— numeric quality score.../badges/qtmesh-errors.svg/qtmesh-warnings.svg.../badges/qtmesh-models.svg(animations, skeletons, materials, …)
Example markdown
Ingest scan
Upload qtmesh scan --json output with your project ingest token (not your login session).
Ingest tokens
Active tokens are listed by creation time. Values are never shown again after creation—use Regenerate to replace all tokens for a project with a new one (shown once), or Delete to revoke a token without creating a replacement.
Base URL
Authentication
- Browser session:
Authorization: Bearer <qtm_sess_…>after login or GitHub OAuth. - Ingest:
Authorization: Bearer <qtm_… project token>onPOST /v1/ingest/scan.
Common endpoints
GET /v1/auth/me— current userGET /v1/projects— list projectsPOST /v1/projects— create (returns ingest token once)GET /v1/ingest-tokens— list active ingest tokens (metadata only)DELETE /v1/ingest-tokens/:id— revoke a tokenPOST /v1/projects/:slug/tokens/regenerate— revoke project tokens, new token in response onceGET /v1/projects/:slug— detail + recent scansGET /v1/dashboard/quality-trend— score trend for the dashboard chart
Full reference: docs/API.md in the repository.