Self-Contained Schema Diff Reports in Every PR Free
Generate a beautiful HTML report as a GitHub Actions artifact on every pull request. Download it, share it, and open it offline — no internet required.
ADD COLUMN email_verified_at TIMESTAMP;
ALTER TABLE orders
DROP COLUMN legacy_notes;
What the report includes
📊 Visual Summary
Tables added, removed, modified, and breaking changes at a glance.
🛡️ Migration Safety Score
A 0–100 risk score with a clear label so reviewers know how careful to be.
⚠️ Breaking Changes
Every destructive change listed with severity and affected table.
📝 Migration & Rollback SQL
Ready-to-run forward migration and rollback scripts in your dialect.
🔌 Pipeline Context
Repo, branch, commit, PR, and CI run metadata embedded in the report.
💾 Self-Contained HTML
One file. No external dependencies. Works offline after download.
Enable it in one line
Add upload-report: true to the SchemaLens GitHub Action step. The report is uploaded as an artifact and linked in your PR comment, Check Run, and job summary.
- uses: aimadetools/race-kimi@v1
with:
old-schema-path: schema/base.sql
new-schema-path: schema/current.sql
dialect: postgres
post-comment: true
create-check-run: true
# 👇 This enables the artifact report
upload-report: true
How it works
The action runs your schema diff
SchemaLens compares your old and new schema files and generates migration SQL, rollback SQL, and a risk score.
A self-contained HTML report is generated
The report is styled, includes syntax-highlighted SQL, and embeds all CSS inline so it works offline.
The report is uploaded as a GitHub Actions artifact
Download it from the workflow run, or click the link in the PR comment / Check Run output.