Public repo atlasGenerated with review notes

onboardy.dev/repos/bubblelabai/bubblelab

bubblelabai/bubblelab

Understand bubblelabai/bubblelab with an Onboardy architecture map, key systems, files to read first, evidence, and agent-ready context.

Published

Jun 3, 2026

Analysis

Jun 3, 2026

Files indexed

2,118

Evidence points

13

Files
2,118
Systems
8
Graph Edges
18
Freshness
Jun 3, 2026

Architecture map

How the repo is organized

Click systems in the graph to inspect responsibilities, important files, and nearby dependencies.

Diagram quality

Generated draftPoor0/100 layout score

Generated draft: use it for orientation, then verify components and edges in source before relying on the layout.

Nodes: 12
Edges: 18
Overlap risk: 29
Crossing risk: 13

Layout checks

  • - 29 node overlap risks detected.
  • - 13 likely edge crossings may reduce readability.
  • - 4 edges flow backward, which can hurt scanability.
Mini Map
Node Types
Gateway
Client
Service
Database
External

Click a system in the map

Explore bubblelabai/bubblelab by selecting services, gateways, clients, and data stores. Each node shows the files, responsibilities, and neighboring systems an agent should keep in scope.

Pan, zoom, and use the minimap to keep large repos navigable.

Sign up to turn selected graph context into repo-aware agent sessions.

Key systems

What an agent should understand first

Bubble Studio (Frontend)

React IDE for building, editing, and testing BubbleFlows with visual flow editor, parameter configuration, and execution monitoring

apps/bubble-studio/src/main.tsxapps/bubble-studio/src/lib/api.ts
Auth & Session Management

Clerk authentication, JWT token validation, OAuth state management, user session tracking

apps/bubblelab-api/src/middleware/auth.jsapps/bubble-studio/src/components/AuthWrapper.tsx
API Gateway (Hono REST)

REST API router, request validation, OpenAPI documentation, middleware orchestration for all endpoints

apps/bubblelab-api/src/index.tsapps/bubblelab-api/src/routes/bubble-flows.ts
Code Validator & Parser

TypeScript code parsing, BubbleFlow AST extraction, parameter detection, type validation, error reporting

packages/bubble-runtime/src/validation/index.tspackages/bubble-runtime/src/parse/BubbleScript.ts
Execution Engine (BubbleRunner)

Dynamic TypeScript code execution, BubbleFlow instantiation, context injection, execution lifecycle orchestration

packages/bubble-runtime/src/runtime/BubbleRunner.tsapps/bubblelab-api/src/services/execution.ts
Bubble Factory & Registry

70+ service integrations (Slack, Salesforce, PostgreSQL, GCP, etc.), plugin instantiation, capability metadata, type safety

packages/bubble-core/src/index.tspackages/bubble-core/src/bubble-factory.ts
Webhook Router & Event Handler

HTTP webhook routing, Slack event processing (URL verification, events, messages), trigger matching, event transformation

apps/bubblelab-api/src/routes/webhooks.tsapps/bubblelab-api/src/utils/payload-transformer.ts
Credential & OAuth Manager

OAuth flow orchestration, credential encryption/storage, token refresh, provider-specific auth handling (Google, Slack, Salesforce, etc.)

apps/bubblelab-api/src/routes/oauth.tsapps/bubblelab-api/src/services/oauth-service.ts

Evidence coverage

What this context is grounded in

Coverage

Citations
8
Findings
5
Indexed entities
Unknown
Relationships
Unknown

Languages

TypeScriptSQLJSONJavaScriptPython