Leandro Mantovani

Leandro Mantovani

The Hidden Cost of IDP Portals

The Hidden Cost of IDP Portals

Let’s get technical about what building a bespoke Internal Developer Portal (IDP) actually entails. Backstage is a phenomenal tool for enterprises with thousands of engineers, dedicated tooling teams, and massive platform budgets. But for lean, rapidly scaling startups, it is often a Trojan horse of technical debt that quietly consumes engineering bandwidth.

When you adopt an open-source portal framework like Backstage, you aren't just deploying a simple Docker container or a Helm chart. You are taking on the complete software development lifecycle (SDLC) for a brand-new internal product. 

The TypeScript and React Tax

Backstage is inherently a framework for building a developer portal, not a turnkey portal itself. Architecturally, it requires maintaining a large Yarn workspace containing both an Express.js backend and a complex React frontend. 

Consider your platform engineering or SRE team. These are typically engineers who specialize in Kubernetes, AWS networking, Terraform, Go, Python, or advanced Bash scripting. By mandating a Backstage deployment, you are suddenly forcing infrastructure experts to become full-stack JavaScript developers. They are tasked with configuring Webpack, resolving Node.js dependency tree conflicts, and debugging intricate React component states just to render a table of microservices. This "React Tax" fundamentally misallocates your most expensive, specialized infrastructure talent.

Plugin Maintenance Burden

To get any actual value out of an IDP, it needs to ingest data from your existing toolchain. Datadog, GitHub Actions, AWS EKS, PagerDuty, SonarQube, ArgoCD—the list goes on. While the open-source community provides a marketplace of plugins, the reality of integrating them in a production environment is brutal. 

Plugins frequently drift out of date, clash with core Backstage version upgrades, or simply don't fit your bespoke architectural edge cases. Managing API rate limits, handling token rotations for your CI/CD integrations, and ensuring the PostgreSQL/SQLite database backing your catalog doesn't become a bottleneck becomes a full-time job. Your platform team ends up maintaining custom API integrations and debugging frontend routing instead of building core, scalable infrastructure automation.

YAML Drift and the Single Pane of Lies

A software catalog relies heavily on metadata. In the DIY Backstage world, this usually means catalog-info.yaml files scattered across dozens, if not hundreds, of disparate repositories. 

Without stringent, automated governance and custom catalog processors validating these files during the CI process, this metadata quickly rots. Repositories get renamed, owners leave the company, and API endpoints shift. The promised "single pane of glass" rapidly shatters into a "single pane of lies." Once developers realize the catalog data is inaccurate, their trust in the portal plummets to zero, and adoption flatlines.

At Betta, we see this exact anti-pattern repeatedly. A scaling startup decides to build an IDP to increase velocity, but ends up dedicating crucial, core engineering cycles to managing an internal tool that doesn't generate a single dollar of revenue.


Platform as a Product (PaaP): Changing the Paradigm

To escape the Backstage Hangover, engineering leadership needs to reframe how they view platform engineering. The ultimate goal isn't to build a visually appealing portal; the goal is to build a paved road.

Treating your platform as a product (PaaP) means treating your internal developers as your primary customers. When you adopt a PaaP mindset, you start conducting actual user research. You ask your product engineers: What is actually slowing you down? What is causing you the most friction on a daily basis?

More often than not, the answer isn't "I don't have a UI to view my services." The answers are deeply rooted in workflow bottlenecks:

  • "It takes me three days, five Jira tickets, and a Slack thread with DevOps to get a new PostgreSQL database provisioned."

  • "I have no idea how to properly configure our GitHub Actions pipelines for a new Node.js service without copy-pasting from a legacy repo."

  • "Spinning up an ephemeral environment for integration testing requires a Ph.D. in Kubernetes and Helm."

A true IDP must be an engine for self-service. It should provide scaffolding templates that instantly spin up a new microservice with best-practice Dockerfiles, Terraform configurations, security scanning, and CI/CD workflows already injected and compliant with company policy. 

If your platform team is spending their time fixing a CSS alignment bug on a React dashboard or upgrading an Express.js backend, they aren't building these critical paved roads. 


How Betta Resolves the Trap: The Lean IDP Stack

Recently, a Series B B2B SaaS company came to Betta in a state of crisis. They had an engineering team of 60, but their time-to-market had ground to an agonizing halt. They had assigned four of their most senior backend and infrastructure engineers to build and maintain a custom Backstage instance to wrangle their sprawling microservices architecture. 

Those four engineers were drowning in frontend bugs, plugin conflicts, and YAML validation issues. Meanwhile, the rest of the development team was chronically blocked, waiting days for basic infrastructure provisioning because the core infrastructure experts were busy playing UI developers.

Here is exactly how Betta’s fractional engineering team resolved the bottleneck and restored engineering velocity:

Step 1: Rip Out the Heavy Lift, Bring in SaaS

We immediately paused development on the bespoke Backstage portal. We transitioned the client to a modern, managed SaaS IDP (in this case, Port, though Cortex and OpsLevel are also excellent, enterprise-grade choices). 

By leveraging a SaaS tool, we instantly offloaded the burden of hosting, patching, securing, and maintaining a React frontend and Node backend. The UI problem was permanently solved by a vendor, allowing the internal team to refocus entirely on business value.

Step 2: Buy the Glass, Build the Automation

With the "single pane of glass" provided by a fully managed vendor, Betta’s fractional SREs got to work on what actually mattered: the complex infrastructure automation beneath the glass. 

We used the SaaS IDP's robust API and webhook system to connect directly to their GitHub Actions runners. We built secure, standardized Terraform modules for their AWS infrastructure, encapsulating best practices for security and high availability. 

Now, when a developer clicks "Create New Service" in the SaaS portal, a webhook triggers a GitHub Action, which securely invokes our custom Terraform modules. This completely automated workflow provisions an EKS namespace, an RDS database, the necessary IAM roles, and injects the baseline repository code—all in under five minutes, completely hands-off.

Step 3: Elastic Talent for an Elastic Problem

Because the client utilized Betta's fractional Platform Engineering services, they didn't need to hire a full-time, expensive Platform team just to set up the initial automation layer. 

We brought in specialized experts to build the complex, high-friction paved roads, integrated them seamlessly into the SaaS portal, documented the workflows comprehensively, and transitioned the daily operation back to their leaner in-house DevOps personnel. 

The result? Those four senior backend engineers were reallocated back to building the company's core, revenue-generating product. Lead time for infrastructure changes dropped from days to minutes, and overall time-to-market improved by 45% within two months. 


Measuring the Right Metrics: Validating Your Platform

How do you know if your platform engineering strategy is actually working, or if you're just introducing another layer of architectural complexity? You need to track the right metrics. 

At Betta, we rigorously tie platform initiatives back to DORA metrics and cognitive load indicators to ensure measurable ROI:

1.  Deployment Frequency: Are developers shipping smaller, safer batches more often because the CI/CD paved road is seamless and trusted?

2.  Lead Time for Changes: How long does it take from an initial commit to code running in production? If developers are waiting on IT or DevOps tickets to provision infrastructure, this number goes up. Robust self-service portals drive this number down significantly.

3.  Mean Time to Recovery (MTTR): Does your portal provide easy, centralized access to incident runbooks, Datadog observability dashboards, and PagerDuty alerts, allowing developers to resolve live incidents faster?

4.  Developer Cognitive Load: While harder to measure quantitatively, this is easily tracked via quarterly SPACE framework surveys. Are developers feeling overwhelmed by YAML, Kubernetes manifests, and pipeline scripts, or are they focused purely on writing business logic?

If your IDP implementation is not actively improving these specific metrics, you are likely suffering from the Backstage Hangover. 

The Bottom Line

Platform engineering is not about building UI dashboards and software catalogs from scratch; it’s about ruthlessly eliminating friction from your software development lifecycle. For scaling startups, dedicating scarce, highly paid engineering cycles to building internal DIY portals is a luxury you simply cannot afford.

Adopt the Platform as a Product (PaaP) mindset, leverage lean SaaS alternatives to buy the UI layer, and rely on specialized technical experts to build the underlying automation that actually moves the needle. Your developers—and your CFO—will thank you.

Cloud Infrastructure Experts

AWS cloud experts delivering scalable, secure,

and cost-efficient infrastructure solutions for growing teams.

Let’s Talk

Get expert guidance on secure

and scalable cloud solutions.

Cloud Infrastructure Experts

AWS cloud experts delivering scalable, secure,

and cost-efficient infrastructure solutions for growing teams.

Let’s Talk

Get expert guidance on secure

and scalable cloud solutions.

Cloud Infrastructure Experts

AWS cloud experts delivering scalable, secure,

and cost-efficient infrastructure solutions for growing teams.

Let’s Talk

Get expert guidance on secure

and scalable cloud solutions.

Cloud Infrastructure Experts

AWS cloud experts delivering scalable, secure,

and cost-efficient infrastructure solutions for growing teams.

Let’s Talk

Get expert guidance on secure and scalable

cloud solutions.