# Roadie - fully customizable Context Layer & Internal Developer Portal built on Backstage

> Roadie is a customizable Context Layer & Internal Developer Portal with scorecards, self-service workflows, and actionable insights.

For clean markdown, append `.md` to docs, blog, case study, and backstage weekly URLs.

## Key Pages

- [Roadie Home](https://roadie.io/)
- [Start Free Trial](https://roadie.io/free-trial/)
- [Pricing](https://roadie.io/pricing/)
- [Request a Demo](https://roadie.io/request-demo/)
- [Context graph waitlist](https://roadie.io/context-graph-waitlist/)
- [Access Control](https://roadie.io/product/access-control/)
- [Service Catalog](https://roadie.io/product/catalog/)
- [Documentation Portal (TechDocs)](https://roadie.io/product/documentation/)
- [Software Templates (Scaffolder)](https://roadie.io/product/scaffolder/)
- [Tech Insights](https://roadie.io/product/tech-insights/)
- [About Roadie](https://roadie.io/about/)
- [Roadie vs Self-hosted Backstage](https://roadie.io/compare/backstage/)
- [FAQs](https://roadie.io/faqs/)

## Documentation

Technical documentation for setting up and using Roadie

- [Authorization of the API](https://roadie.io/docs/api/authorization.md)
- [Entity Push API](https://roadie.io/docs/api/entity-push-api.md)
- [Roadie API & MCP Servers](https://roadie.io/docs/api/overview.md)
- [Roadie MCP AI Servers (Beta)](https://roadie.io/docs/api/roadie-mcp.md)
- [API Docs Query Server](https://roadie.io/docs/api/roadie-mcp/api-docs-query.md)
- [Backend Config Server](https://roadie.io/docs/api/roadie-mcp/backend-config.md)
- [Catalog Decorators Server](https://roadie.io/docs/api/roadie-mcp/catalog-decorators.md)
- [Rich Catalog Entity Server](https://roadie.io/docs/api/roadie-mcp/rich-catalog-entity.md)
- [Scaffolder Server](https://roadie.io/docs/api/roadie-mcp/scaffolder.md)
- [Tech Insights Facts Server](https://roadie.io/docs/api/roadie-mcp/tech-insights-facts.md)
- [Building your Catalog](https://roadie.io/docs/catalog/building-your-catalog.md)
- [Catalog data sources](https://roadie.io/docs/catalog/building-your-catalog/data-sources.md)
- [Integrations for Building your Catalog](https://roadie.io/docs/catalog/building-your-catalog/integrations.md)
- [Workflows to create entities](https://roadie.io/docs/catalog/building-your-catalog/workflows.md)
- [Use custom renderer with your API entities](https://roadie.io/docs/catalog/custom-api-docs-renderers.md)
- [Custom Cards [beta]](https://roadie.io/docs/catalog/custom-cards.md)
- [Customising your Catalog](https://roadie.io/docs/catalog/custom-views.md)
- [Introduction](https://roadie.io/docs/catalog/decorating-components.md)
- [Displaying Entity Metadata](https://roadie.io/docs/catalog/entity-metadata-card.md)
- [Use the grpc-docs plugin with your API entities](https://roadie.io/docs/catalog/grpc-docs.md)
- [Managing locations and autodiscovery](https://roadie.io/docs/catalog/location-management.md)
- [Modeling Entities in the Catalog](https://roadie.io/docs/catalog/modeling-entities.md)
- [Using OpenAPI Specs](https://roadie.io/docs/catalog/openapi-specs.md)
- [Roadie Catalog](https://roadie.io/docs/catalog/overview.md)
- [Ownership in Backstage Entities](https://roadie.io/docs/catalog/ownership.md)
- [Testing Components and Previewing Entity Changes](https://roadie.io/docs/catalog/previewing-changes.md)
- [Repositories in the Catalog](https://roadie.io/docs/catalog/repositories.md)
- [Creating rich team pages](https://roadie.io/docs/catalog/rich-team-pages.md)
- [Testing Page Configurations](https://roadie.io/docs/catalog/sandbox-mode.md)
- [Showing Relationships Between Entities](https://roadie.io/docs/catalog/showing-dependencies.md)
- ... and 207 more docs

## Blog

Articles about Backstage, developer portals, and platform engineering

- [The Word 'Context' Has Stopped Meaning Anything](https://roadie.io/blog/context-engineering-definition-problem.md)
- [Why AI-augmented squads keep building the same thing twice](https://roadie.io/blog/ai-augmented-squads-service-duplication.md)
- [Why Your MCP Server Might Be Eating Your Context Window (and How to Fix It)](https://roadie.io/blog/mcp-server-context-window.md)
- [The Context Engineering Checklist: 15 Questions to Ask Before Choosing an AI-Powered Developer Platform](https://roadie.io/blog/context-engineering-checklist-ai-developer-platform.md)
- [What Your Engineering Organisation Doesn't Know About Itself](https://roadie.io/blog/engineering-organisation-opacity-ai-agents.md)
- [The 5 Types of Engineering Context Your AI Agent Needs to Be Useful in Production](https://roadie.io/blog/engineering-context-ai-agents-production.md)
- [The Agent Stack's Missing Layer](https://roadie.io/blog/the-agent-stacks-missing-layer.md)
- [The Governance Gap in Agent-Stack Thinking](https://roadie.io/blog/governance-gap-agent-stack.md)
- [Context, Agents, MCP: A Working Glossary for Platform Teams](https://roadie.io/blog/context-agents-mcp-glossary.md)
- [Smart Agents Need Smart Context: The Four Motions of a Context Layer](https://roadie.io/blog/smart-agents-smart-context.md)
- [AI Coding Assistants Can Read Your Code. They Can't See Your Platform.](https://roadie.io/blog/ai-coding-assistants-missing-platform-context.md)
- [Context Engineering for Developers: The Infrastructure Layer That Makes AI Actually Useful](https://roadie.io/blog/context-engineering-for-developers-ai-infrastructure.md)
- [Why Conflating RAG with Context Engineering Costs You in Production](https://roadie.io/blog/rag-vs-context-engineering-production.md)
- [Context Engineering Is the Prerequisite Your Enterprise AI Deployment Is Missing](https://roadie.io/blog/context-engineering-enterprise-ai-prerequisite.md)
- [Prompt Engineering vs Context Engineering: What's the Actual Difference and Why It Matters for Production AI](https://roadie.io/blog/prompt-engineering-vs-context-engineering.md)
- [Your IDP Is an AI Goldmine: How Internal Developer Platforms Enable Context Engineering](https://roadie.io/blog/idp-ai-goldmine-context-engineering.md)
- [Backstage and its Place Among Developer Portals: A Technical Architecture Guide](https://roadie.io/blog/backstage-and-its-place-among-developer-portals.md)
- [Context Engineering: The Missing Discipline in AI-Assisted Development](https://roadie.io/blog/context-engineering-ai-development.md)
- [The Context Engineering Glossary for Platform Engineers](https://roadie.io/blog/context-engineering-glossary.md)
- [Splitting TechDocs Out of Our Monolithic Backstage Deployment](https://roadie.io/blog/splitting-techdocs-out-of-our-monolithic-backstage-deployment.md)
- ... and 96 more posts

## Case Studies

Customer success stories and implementation examples

- [Motability Operations: Building a Modern Developer Platform with Roadie](https://roadie.io/case-studies/motability-operations-case-study-a-modern-idp.md)
- [Maintenance to Momentum: Why Celonis Made the Switch from Self-Hosted Backstage to Roadie](https://roadie.io/case-studies/why-celonis-switched-from-selfhosted-backstage-to-roadie.md)
- [Dexcom: Automating Backstage Catalog Completeness with Roadie](https://roadie.io/case-studies/dexcom-automating-catalog-completeness-backstage.md)
- [Improving software standards with Roadie](https://roadie.io/case-studies/improving-software-standards-with-roadie.md)
- [Growing and Governing an Internal Developer Portal in a Regulated business](https://roadie.io/case-studies/growing-and-governing-an-internal-developer-portal-in-a-regulated-business.md)
- [Transitioning from Self-Hosted Backstage to Roadie](https://roadie.io/case-studies/from-self-hosted-backstage-to-roadie.md)
- [Velocity through hypergrowth with Roadie](https://roadie.io/case-studies/maintaining-velocity-through-hypergrowth-contentful.md)
- [Handling rapid growth with Backstage](https://roadie.io/case-studies/lunar-backstage-adoption.md)
- [Backstage at Expedia Group](https://roadie.io/case-studies/expedia-group-backstage-mvp.md)

## Optional

The following sections can be skipped if a shorter context is needed.

- [AI Assistant](https://roadie.io/backstage/plugins/ai-assistant-rag-ai/): Backstage plugin
- [Airbrake](https://roadie.io/backstage/plugins/airbrake/): Backstage plugin
- [Allure Reports](https://roadie.io/backstage/plugins/allure/): Backstage plugin
- [Amplication Resources](https://roadie.io/backstage/plugins/amplication-resources/): Backstage plugin
- [Analytics Module: Generic HTTP](https://roadie.io/backstage/plugins/analytics-module-generic-http/): Backstage plugin
- [Announcements](https://roadie.io/backstage/plugins/announcements/): Backstage plugin
- [Apache Airflow](https://roadie.io/backstage/plugins/apache-airflow/): Backstage plugin
- [API Docs](https://roadie.io/backstage/plugins/api-docs/): Backstage plugin
- [API Linter](https://roadie.io/backstage/plugins/api-linter/): Backstage plugin
- [API Spectral Linter](https://roadie.io/backstage/plugins/api-spectral-linter/): Backstage plugin
- [APIs with 3scale](https://roadie.io/backstage/plugins/ap-is-with-3-scale/): Backstage plugin
- [Apollo Explorer](https://roadie.io/backstage/plugins/apollo-explorer/): Backstage plugin
- [Application Topology for Kubernetes](https://roadie.io/backstage/plugins/application-topology-for-kubernetes/): Backstage plugin
- [Architecture Decision Records](https://roadie.io/backstage/plugins/architecture-decision-records/): Backstage plugin
- [Argo CD](https://roadie.io/backstage/plugins/argo-cd/): Backstage plugin
- [Artifacts Plugin for JFrog Artifactory](https://roadie.io/backstage/plugins/artifacts-plugin-for-j-frog-artifactory/): Backstage plugin
- [AuthN and AuthZ with Keycloak](https://roadie.io/backstage/plugins/authn-and-authz-with-keycloak/): Backstage plugin
- [AWS CloudFormation](https://roadie.io/backstage/plugins/aws-cloud-formation/): Backstage plugin
- [AWS Lambda](https://roadie.io/backstage/plugins/aws-lambda/): Backstage plugin
- [AWS Proxy SigV4](https://roadie.io/backstage/plugins/aws-proxy-sigv4/): Backstage plugin
- [Azure DevOps](https://roadie.io/backstage/plugins/azure-devops/): Backstage plugin
- [Azure DevOps Wiki Search](https://roadie.io/backstage/plugins/azure-dev-ops-wiki-search/): Backstage plugin
- [Azure Pipelines](https://roadie.io/backstage/plugins/azure-pipelines/): Backstage plugin
- [Azure Resources](https://roadie.io/backstage/plugins/azure-resources/): Backstage plugin
- [Azure Sites](https://roadie.io/backstage/plugins/azure-sites/): Backstage plugin
- [186 more plugins](https://roadie.io/backstage/plugins/): Backstage plugin
- [Run Example Action](https://roadie.io/backstage/scaffolder-actions//acme-example//): Scaffolder action
- [Amplication Service Scaffold](https://roadie.io/backstage/scaffolder-actions//amplication-scaffold-service//): Scaffolder action
- [Launch Ansible Job Template](https://roadie.io/backstage/scaffolder-actions//ansible-job-template-launch//): Scaffolder action
- [Create Argo CD Resources](https://roadie.io/backstage/scaffolder-actions//argocd-create-resources//): Scaffolder action
- [Create AWS CloudControl Resource](https://roadie.io/backstage/scaffolder-actions//aws-cloudcontrol-create//): Scaffolder action
- [Publish To AWS CodeCommit](https://roadie.io/backstage/scaffolder-actions//aws-codecommit-publish//): Scaffolder action
- [Publish EventBridge Event](https://roadie.io/backstage/scaffolder-actions//aws-eventbridge-event//): Scaffolder action
- [Copy Files To S3](https://roadie.io/backstage/scaffolder-actions//aws-s-3-cp//): Scaffolder action
- [Create Azure DevOps Pipeline](https://roadie.io/backstage/scaffolder-actions//azure-pipeline-create//): Scaffolder action
- [Permit Azure Pipeline Run](https://roadie.io/backstage/scaffolder-actions//azure-pipeline-permit//): Scaffolder action
- [Run Azure Pipeline](https://roadie.io/backstage/scaffolder-actions//azure-pipeline-run//): Scaffolder action
- [Create Azure DevOps PR](https://roadie.io/backstage/scaffolder-actions//azure-pr-create//): Scaffolder action
- [Clone Azure Repository](https://roadie.io/backstage/scaffolder-actions//azure-repo-clone//): Scaffolder action
- [Azure Repos Pull Request](https://roadie.io/backstage/scaffolder-actions//azure-repo-pr//): Scaffolder action
- [Azure Repo Push](https://roadie.io/backstage/scaffolder-actions//azure-repo-push//): Scaffolder action
- [Clone Azure Repository](https://roadie.io/backstage/scaffolder-actions//azure-repository-clone//): Scaffolder action
- [Push To Azure Repos](https://roadie.io/backstage/scaffolder-actions//azure-repository-push//): Scaffolder action
- [Run Bitbucket Cloud Pipeline](https://roadie.io/backstage/scaffolder-actions//bitbucket-pipelines-run//): Scaffolder action
- [Create Bitbucket Branch Restrictions](https://roadie.io/backstage/scaffolder-actions//bitbucket-cloud-branch-restriction-create//): Scaffolder action
- [Create Black Duck Project](https://roadie.io/backstage/scaffolder-actions//blackduck-create-project//): Scaffolder action
- [126 more actions](https://roadie.io/backstage/scaffolder-actions/): Scaffolder action
- [MCP Actions Security, Node.js CVE and Context Window Costs](https://roadie.io/backstage-weekly/139-mcp-permissions-cve-context-window.md): Backstage Weekly newsletter
- [Backstage v1.52.0, Connections Service and AI-Augmented Squads](https://roadie.io/backstage-weekly/138-v1-52-0-connections-ai-squads.md): Backstage Weekly newsletter
- [v1.52.0-next.0, Catalog Stitching Fixes, and Engineering Org Opacity](https://roadie.io/backstage-weekly/137-v1-52-next-0-stitch-reliability.md): Backstage Weekly newsletter
- [Catalog Export, Query Performance and v1.52.0 Preview](https://roadie.io/backstage-weekly/136-catalog-export-query-performance.md): Backstage Weekly newsletter
- [Backstage v1.51.0, AiResource Kind and Scaffolder 4.0](https://roadie.io/backstage-weekly/135-v1-51-0-airesource-kind-scaffolder-4.md): Backstage Weekly newsletter
- [The Agent Stack's Missing Layer, Scaffolder Template Groups and Backstage v1.51.0-next.3](https://roadie.io/backstage-weekly/134-agent-stack-missing-layer.md): Backstage Weekly newsletter
- [Backstage v1.51.0-next.2, Microsoft Graph Ingestion and an MCP Glossary](https://roadie.io/backstage-weekly/133-v1-51-next-2-msgraph-agent-context.md): Backstage Weekly newsletter
- [AI Assistants Can't See Your Platform, v1.50.3, and RemixIcons License Issue](https://roadie.io/backstage-weekly/132-ai-assistants-cant-see-your-platform.md): Backstage Weekly newsletter
- [Context Engineering for Developers, AIContext RFC, and New Releases](https://roadie.io/backstage-weekly/131-context-engineering-for-developers-and-new-releases.md): Backstage Weekly newsletter
- [v1.50.0 Release, BackstageCon Recordings, and Context Engineering](https://roadie.io/backstage-weekly/130-v1-50-0-backstagecon-context-engineering.md): Backstage Weekly newsletter
- [90 more issues](https://roadie.io/backstage-weekly/): Backstage Weekly newsletter
- [Catalog & Ownership](https://roadie.io/backstage-bites/catalog-ownership/): Backstage Bites video tutorial
- [Component Overview Page](https://roadie.io/backstage-bites/component-overview-page/): Backstage Bites video tutorial
- [Component Overview Page Setup](https://roadie.io/backstage-bites/component-overview-page-setup/): Backstage Bites video tutorial
- [Component Tabs](https://roadie.io/backstage-bites/component-tabs/): Backstage Bites video tutorial
- [Adding tabs](https://roadie.io/backstage-bites/adding-tabs/): Backstage Bites video tutorial
- [How Backstage works](https://roadie.io/backstage-bites/how-backstage-works/): Backstage Bites video tutorial
- [API Specs](https://roadie.io/backstage-bites/api-specs/): Backstage Bites video tutorial
- [TechDocs](https://roadie.io/backstage-bites/techdocs/): Backstage Bites video tutorial
- [Scaffolder](https://roadie.io/backstage-bites/scaffolder/): Backstage Bites video tutorial
- [V1](https://roadie.io/legal-notices/acceptable-use-policy/v1/): Legal
- [V2](https://roadie.io/legal-notices/acceptable-use-policy/v2/): Legal
- [V1](https://roadie.io/legal-notices/cookies-policy/v1/): Legal
- [V2](https://roadie.io/legal-notices/cookies-policy/v2/): Legal
- [V3](https://roadie.io/legal-notices/cookies-policy/v3/): Legal
- [V4](https://roadie.io/legal-notices/cookies-policy/v4/): Legal
- [V5](https://roadie.io/legal-notices/cookies-policy/v5/): Legal
- [V6](https://roadie.io/legal-notices/cookies-policy/v6/): Legal
- [V1](https://roadie.io/legal-notices/evaluation-license/v1/): Legal
- [V2](https://roadie.io/legal-notices/evaluation-license/v2/): Legal
- [15 more notices](https://roadie.io/legal-notices/): Legal