La piattaforma
Otto componenti, un piano di controllo
Ciascuno di questi gestisce oggi i nostri prodotti in produzione. Qui sotto: cosa fa ognuno di essi, se è attivo, il comando o l'endpoint con cui lo raggiungi e come i pezzi si incastrano.
Matrice dei componenti
Cosa fa, il suo stato, il suo comando o endpoint e dove risponde.
| Componente | Cosa fa | Stato | CLI / API | Attivo |
|---|---|---|---|---|
| forge-control | Build, deploy, segreti e DNS per ogni app della fleet. | Live | forge app-deploy | Apri ↗ |
| forge-git | Gitea self-hosted più fgit, la CLI di merge attraverso cui passa ogni push della federazione. | Live | fgit pr merge | Apri ↗ |
| forge-auth | Accesso, chiavi API, organizzazioni e diritti per le tue app. | Live | forge login | Apri ↗ |
| packr | Il registry di pacchetti privato da cui ogni deploy installa le proprie dipendenze. | Live | npm config set @blueforge-studio:registry https://api.packr.blueforge.studio | Apri ↗ |
| gateway | Gateway AI multi-tenant: un endpoint, scambio di chiave per tenant, consumo per organizzazione. | Live | POST /v1/proxy | Apri ↗ |
| error tracker | Error tracking self-hosted, proxyato da ogni sito della fleet. | Live | POST /api/events | |
| marketplace | Template di agent-stream firmati e versionati con checkout Stripe test attivo. | Beta | POST /v1/publish | Apri ↗ |
| promotion site | Un sito catalogo per prodotto, riempito dai suoi deploy. | Beta | Apri → |
Come si combinano
Una push arriva su forge-git; forge-control la compila e la distribuisce; forge-auth decide chi può farlo; packr serve i pacchetti che la build installa; il sito promozionale pubblica il risultato come tuo catalogo. L'AI gateway, il tracciamento degli errori e il marketplace si agganciano a questa spina dorsale.
Quickstart
Tre comandi da un terminale vuoto a un'app distribuita:
npm i -g @blueforge-studio/forge
forge login
forge app-deployDomande
BlueForge è self-hosted?
Sì — questa è la nostra stessa produzione: forge-git è Gitea, forge-control compila e distribuisce, e ogni host gira dietro il nostro Caddy. La documentazione spiega come integrarsi, e ogni pagina di componente dice chiaramente cosa è live e cosa è ancora in chiusura.
Devo spostare il mio codice da GitHub?
No. Il registry, i sidecar e i pacchetti pubblici funzionano da qualsiasi CI — GitHub Actions incluso. Mantieni il tuo remote, valida i tuoi sidecar nel tuo pipeline e registra ogni deploy con POST /api/deployments usando una chiave organizzazione forge-auth.
Sono lock-in?
No. Il tuo codice resta in git, i tuoi sidecar sono due file YAML nel tuo repo, e ogni servizio parla HTTP con endpoint documentati. Il catalogo si riempie dai tuoi deploy — smetti di distribuire e si fa silenzioso; nient'altro si rompe.