Skip to content
Overview

What is Theseus?

Theseus is GitLab’s developer platform for building new services. Think of it like a factory line for new software: instead of every team building the on-ramp themselves — the code setup, the security checks, the monitoring, the way it gets released — Theseus builds all of that for them automatically. A team presses go and gets back a working, ready-to-launch service.

The problem it solves

Right now, before a team can even start building a new service, they spend weeks doing setup work that has nothing to do with the actual feature: creating the project, connecting it to GitLab’s systems, adding monitoring, and passing a safety review. Every team does this exact same setup, customers never see it, and it slows everyone down in the same way.

Why now

GitLab has run as one large, single codebase for years. That’s made it harder to move fast, scale reliably, and let teams work independently. GitLab decided now is the time to break that one codebase into smaller, independent services, and every team that starts this work hits the same weeks of setup. Theseus exists so that work only has to be solved once, not repeated by every team.

Where it fits in the bigger picture

GitLab’s larger plan to reorganize how the company builds and runs its product is called Modular GitLab. Theseus is the tool that the plan depends on: it’s what every team uses each time they build a new service as part of that shift. Without Theseus, each team would have to solve the same setup problem on its own.

What success looks like

  • Building a new service goes from weeks of setup to a few hours.
  • Every new service is built the same way, so any engineer can understand any service.
  • Teams show up to their safety review already prepared, so the review goes fast.
  • Engineers spend their time building the actual feature, not doing setup work.

What Theseus is not

  • Not in charge of rolling this out to customers — deciding when and how customers get upgrades is a different team’s job. Theseus builds the service; other teams decide how and when it reaches customers.
  • Not “Modular GitLab” — that’s GitLab’s bigger plan to reorganize how the whole company builds and runs its product. Theseus is just the tool a team uses to build one new piece of it.
  • Not the “breaking up the monolith” work — deciding to split a piece out is its own decision each team makes. Theseus is what they use once they’ve decided to build something new.
  • Not something customers see or use — it’s for GitLab engineers only, behind the scenes.
  • Doesn’t replace people’s judgment or reviews — teams still decide what to build, and security teams still check it.
  • Not a one-time thing — it’s a platform that GitLab’s infrastructure team keeps building and improving.
Last updated on