Platform Overview

Dart Cloud Functions provides a single control plane for authoring Dart functions, connecting cloud credentials, staging artifacts, and triggering deployments into customer-owned cloud environments.

What The Product Does Today

The current implementation covers:

  • tenant-scoped projects and function records

  • file upload APIs for main.dart, Dockerfile, and pubspec.yaml

  • project-scoped cloud integrations for Azure, AWS, and GCP

  • async deployment orchestration with status polling and event history

  • a database-driven Dart runtime catalog with lifecycle enforcement

Current Architecture

Layer Role

Frontend

Hosts the customer authoring flow for projects, functions, integrations, and deployments.

Public API

Verifies Firebase ID tokens, stores control-plane data, validates contracts, and queues deployments.

Runner

Claims queued deployment rows and executes provider-specific build and deploy steps.

Customer cloud

Owns the target storage, workload identity trust, and runtime resources that receive the deployed function.

Authentication Model

The public product APIs are currently protected by Firebase ID tokens sent as:

Authorization: Bearer <idToken>

The backend derives the active tenant from that verified identity and applies tenant and project scoping from there. Cloud credentials are not global. Each project stores its own provider integration state.

Current Product Boundaries

This repository is not just a runtime image builder. It is the full product surface for:

  • sign-in and tenant bootstrap

  • project and function authoring

  • cloud integration onboarding

  • deployment orchestration

  • billing and plan-aware limits

Current Plan Policy

The current product contract is:

  • Sandbox keeps its trial lifecycle and existing restrictions.

  • Standard, Enhanced, and Enterprise currently allow unlimited tenant-scoped projects.

  • Standard, Enhanced, and Enterprise currently allow unlimited functions per project.

  • Standard remains restricted to GCP-only cloud connectivity and deployment targets.

  • Enhanced and Enterprise use the broader multi-cloud product surface.

Pre-Launch Note

The platform is still pre-launch, so the documentation favors the cleanest current contract over backward compatibility with older draft payloads.