Skip to content

blog: Migrating From The Graph Without a Rewrite#987

Open
Jordy-Baby wants to merge 1 commit into
mainfrom
blog/drop-in-subgraph-replacement
Open

blog: Migrating From The Graph Without a Rewrite#987
Jordy-Baby wants to merge 1 commit into
mainfrom
blog/drop-in-subgraph-replacement

Conversation

@Jordy-Baby

@Jordy-Baby Jordy-Baby commented Jul 1, 2026

Copy link
Copy Markdown
Collaborator

New blog post: a side-by-side guide to migrating a subgraph to Envio HyperIndex as a drop-in replacement, with before/after config, schema, and handler code, the Katana production migration, and benchmark numbers.

  • Adds blog/2026-06-26-drop-in-subgraph-replacement.md (slug /blog/drop-in-subgraph-replacement)
  • Adds hero asset static/blog-assets/drop-in-subgraph-replacement.png

Verified locally: blog page and hero asset both serve 200 on the docs dev server, no broken-link warnings. Blog index regenerates on build.

Summary by CodeRabbit

  • Documentation
    • Added a new guide on migrating subgraphs to HyperIndex without rewriting existing entity models or handler logic.
    • Covers setup, config and schema updates, handler changes, dynamic data sources, validation steps, and GraphQL compatibility.
    • Includes production migration guidance, performance comparisons, FAQs, and related resources.

@vercel

vercel Bot commented Jul 1, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
envio-docs Error Error Jul 1, 2026 1:13pm

Request Review

@coderabbitai

coderabbitai Bot commented Jul 1, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: c82c8346-e08c-452b-8342-0e42d64165be

📥 Commits

Reviewing files that changed from the base of the PR and between eb4afc6 and c8eeb27.

⛔ Files ignored due to path filters (1)
  • static/blog-assets/drop-in-subgraph-replacement.png is excluded by !**/*.png
📒 Files selected for processing (1)
  • blog/2026-06-26-drop-in-subgraph-replacement.md

📝 Walkthrough

Walkthrough

Adds a new blog post file documenting an end-to-end guide for migrating subgraphs from The Graph to HyperIndex, covering config/schema/handler API changes, dynamic data source handling, migration validation, and FAQs.

Changes

Blog Post Addition

Layer / File(s) Summary
Frontmatter and intro framing
blog/2026-06-26-drop-in-subgraph-replacement.md
Adds post metadata, hero image, TL;DR, and opening framing with links to guided AI migration resources.
Migration surface overview
blog/2026-06-26-drop-in-subgraph-replacement.md
Lists unchanged vs. changed parts of a migration (config, schema, handlers, entity APIs, transaction fields) via a comparison table.
Step-by-step migration walkthrough
blog/2026-06-26-drop-in-subgraph-replacement.md
Walks through bootstrapping a project, converting subgraph.yaml to config.yaml, updating the GraphQL schema, and rewriting handler code including dynamic data source registration.
Validation, production results, and FAQs
blog/2026-06-26-drop-in-subgraph-replacement.md
Describes the Indexer Migration Validator CLI, query compatibility, a production migration example with performance comparison table, and closing FAQ/footer sections.

Estimated code review effort: 1 (Trivial) | ~5 minutes

Suggested reviewers: keenbeen32

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title clearly and concisely matches the new blog post about migrating from The Graph without a rewrite.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@Jordy-Baby

Copy link
Copy Markdown
Collaborator Author

@nikbhintade ready for review when you get a sec 🙏

@Jordy-Baby Jordy-Baby enabled auto-merge (squash) July 1, 2026 13:24
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant