Frequently asked questions

What is schema drift?

Schema drift is when a live API response diverges from its declared contract or spec — a field changes type, a required field goes missing, a nullable field starts returning null unexpectedly. Drift causes silent failures: the spec passes validation but clients break at runtime. Homogenic catches this before it ships.

Does Homogenic modify my code or API?

No. Homogenic is read-only. It analyzes your specs and compares them against actual API responses in CI. It doesn't touch your code, deployments, or runtime.

What languages and frameworks do you support?

Language and framework agnostic. Homogenic works with any stack that produces an OpenAPI 3.x spec, JSON Schema Draft 7+, or GraphQL SDL. The CLI and GitHub Action don't care what your backend is written in.

How does the GitHub integration work?

Homogenic installs as a GitHub App. It adds a required status check to pull requests. When a PR introduces a breaking schema change, the check fails and a detailed diff comment is posted. Reviewers see exactly what changed and why it matters before merging.

Is my schema data stored on your servers?

Specs are analyzed in Homogenic's infrastructure and retained per your plan's history limit (7 days Free, 90 days Pro, 1 year Team). All data is encrypted at rest and in transit. No Homogenic employee accesses your schema data. Enterprise customers can self-host.

How is Homogenic different from Spectral or Stoplight?

Spectral and Stoplight primarily lint your spec for style and correctness. Homogenic's core feature is detecting drift between live API responses and your declared spec. They're complementary: Spectral keeps your spec clean, Homogenic makes sure your API actually matches it.

Can I run Homogenic on-premises?

On-prem deployment is available on the Enterprise plan as Docker images with full support. Email hello@homogenic.dev to discuss.

Do you support AsyncAPI or gRPC/Protobuf?

Both are on the roadmap for Q3 2026. Email us if these are blocking your adoption — we track demand to prioritize.

Is Homogenic SOC 2 certified?

Yes. Homogenic is SOC 2 Type II certified. The report is available to Enterprise customers under NDA. We also support BAA for regulated industries.

How do I migrate from v1.x to v2.x?

The main breaking changes in v2.0: --schema is now --spec, and --output-format is now --format. Most configs update in under 5 minutes. Full guide in docs.

Still have questions?

Email hello@homogenic.dev and a human will respond, usually within one business day.