Sign in

Core concepts

Projects

The top-level unit on Bleenk — git tree, containers, volumes, permissions, and architecture graph.

On Bleenk cloud, a project is the top-level unit of work. It combines a git-backed working tree, one or more runtime containers, a persistent volume, team permissions, and an architecture graph that drives the Architecture Panel.

Creating projects

  • Templates

    Curated stacks with sane defaults — frontend, API, database, and worker wiring included.

  • Git import

    Connect a remote repository; Bleenk clones and wires containers from your stack.

  • Agent scaffold

    Describe the product in chat; the agent creates the repo, config, and first deploy graph.

Architecture Panel

The panel visualizes containers (app, API, worker, database), edges between them, and deploy targets. Edits persist to your project config so humans and agents share one source of truth.

json
{
  "containers": [
    { "id": "web", "type": "nextjs", "port": 3000 },
    { "id": "api", "type": "node", "port": 4000 }
  ],
  "edges": [{ "from": "web", "to": "api" }],
  "deploy": [{ "container": "web", "target": "vercel", "env": "production" }]
}

Team access

Invite teammates at the workspace level, then scope project roles — viewer, editor, or admin — per project.