Riven AIDocs

Dev Center Overview

Service catalog, deployment management, and API documentation for your microservices.

What is the Dev Center?

The Dev Center is Riven AI's service management and deployment platform. It provides a unified interface for service registration, deployment management, environment provisioning, and API documentation — all built on Connect RPC, MongoDB, and Kubernetes.

Rather than juggling multiple dashboards and CLI tools, the Dev Center brings everything into a single, consistent experience designed for engineering teams that move fast.

The Dev Center is one of six core products in the Riven AI platform. For other capabilities, see AI Platform, Agents, and Infrastructure.

The Dev Center follows a proto-first approach — Protocol Buffers are the source of truth for all service APIs. Update .proto files first, run codegen, then implement.

Key Features

The Dev Center is organized around four core capabilities that cover the full service lifecycle:

  • Service Catalog — Register, discover, and browse all microservices in your organization. Automatically syncs with Kubernetes for live status and metadata.
  • Deployment Management — Deploy services across environments with Helm-based releases, rollback support, and blue-green deployment strategies.
  • Environment Provisioning — Spin up isolated environments for development, staging, and production with consistent configuration and secrets management.
  • API Documentation — Auto-generated API docs from Protobuf definitions, with interactive exploration and versioning.

Architecture

The Dev Center is composed of three main layers: a Next.js frontend, an Express/Connect RPC backend, and a set of infrastructure adapters that interface with Kubernetes, Helm, ECR, and Pulumi.

Architecture
text
┌─────────────────────────────────────────┐
│           Next.js Frontend              │
├─────────────────────────────────────────┤
│      Express + Connect RPC Backend      │
├──────────┬──────────┬──────┬────────────┤
│    K8s   │   Helm   │ ECR  │   Pulumi   │
│ Adapter  │ Adapter  │ Adpt │  Adapter   │
├──────────┴──────────┴──────┴────────────┤
│        MongoDB  ·  PostgreSQL           │
└─────────────────────────────────────────┘

The backend exposes all operations through Connect RPC endpoints defined in Protobuf. Each adapter encapsulates a specific infrastructure concern, making it straightforward to extend or swap components.

Service Discovery

The Dev Center automatically discovers services running in the Kubernetes cluster using standard labels. Services annotated with Riven-specific labels are automatically indexed in the catalog and monitored for health.

kubernetes-labels.yaml
yaml
metadata:
  labels:
    riven.dev/service-type: backend
    riven.dev/base-chart: js-service-base
    riven.dev/team: platform
    riven.dev/env: production

Getting Started

To start using the Dev Center, ensure you have access to the Kubernetes cluster and the necessary IAM permissions. Then follow these steps:

  1. Register your service in the catalog with the required Kubernetes labels.
  2. Define your API using Protobuf and run the codegen pipeline.
  3. Deploy your service using the Helm chart and the Platform dashboard.
  4. Monitor health and performance through the integrated observability stack.
Terminal
bash
# Install the Riven CLI
curl -fsSL https://get.riven-ai.dev | bash
 
# Authenticate with your cluster
riven auth login
 
# Scaffold a new service
riven service create my-service --type backend --chart js-service-base
 
# Generate proto stubs
riven proto generate

Check out the Services page for detailed instructions on registering your first microservice in the catalog.

PreviousAuthenticationNextServices