Criar um projeto
Envie um .zip e crie um projeto. A Cube instala as dependências e, com start=true, inicia o projeto sozinha.
.zip como multipart/form-data no campo file. A configuração vem do cube.json na raiz do .zip, ou dos campos do formulário. Sem código ainda? Mande template no lugar do file e comece por um template da Cube.
Envio
.zip e valida a configuração. Se algo estiver errado, nada é criado e a resposta diz o motivo.Instalação
installing. As dependências são instaladas e o build roda, se houver. Acompanhe pelos logs com source=build.Pronto
start=true, o projeto sobe sozinho (running). Sem ele, fica stopped até você iniciar.memoryMb, vale o mínimo do seu plano. Veja Listar planos..zip: mande em variables (JSON [{"name": "DISCORD_TOKEN", "value": "..."}]) e elas são gravadas antes da primeira subida, ou defina depois em Definir variáveis e inicie.Erros comuns
Autorizações
Chave de API da Cube (cube_…), criada no painel em Chaves de API. Mande como Authorization: Bearer cube_…. Cada rota pede uma permissão da chave (o escopo no security da rota, como files:write); sem ela, 403 insufficient_scope com o requiredScope. Veja Chaves de API.
Corpo
Um template da Cube no lugar do file (a lista em Listar templates). Com os dois, nada é criado.
discord-js-bot, discord-py-bot, discord-music-bot, lavalink, discord-postgres-bot, express-api, fastapi-api, static-site Variáveis de ambiente gravadas antes da primeira subida, em JSON: [{"name": "DISCORD_TOKEN", "value": "..."}]. Até 50, com as regras de Definir variáveis.
Com language e command (ou language e entry; ou só language no static, o site só de HTML, no go, no rust, no elixir e no php), o formulário vale e o cube.json é ignorado.
node, python, java, go, php, ruby, dotnet, elixir, rust, static Comando de início, numa linha só. No go e no rust é opcional: sem ele, roda o programa que o build gera (/dados/bin/app; no Rust, o entry de src/bin/<nome>.rs roda o /dados/bin/<nome>). No site php também: sem ele, a Cube serve o site (cube-php-server, com a pasta root ou a public). No elixir também: sem ele, mix run --no-halt. Sem ele, com o entry, o comando sai do arquivo principal (no dotnet, o .dll publicado do projeto, dotnet /dados/publish/<projeto>.dll, ou o .dll pronto, dotnet <entry>).
500O arquivo principal, com a extensão da linguagem (como cmd/bot/main.go, src/Api/Api.csproj ou app.dll). No go, é a pasta que o build compila (sem ele, a raiz do .zip); no dotnet, o projeto que o build publica, em qualquer pasta (sem ele, o único projeto ou a solução da raiz), ou um .dll pronto, que roda sem build. Sem command, o comando sai dele. Fora do formato, 422 invalid_config com field: "entry".
200Comando de instalação, no lugar da instalação automática da linguagem (como npm install --omit=dev). Ausente = a automática; vazio = não instala nada. Numa linha só, sem caractere de controle; fora disso, 422 invalid_config com field: "installCommand". O site estático não tem. Veja installCommand.
500No site php sem command: a pasta que a Cube serve (sem ela, a public quando existe, senão a raiz). No static: a pasta servida, como dist ("" = a raiz). Sem ela, a pasta do index.html mais raso do .zip (a raiz, ou dist quando ele só existe lá). Sem .. nem pasta que começa com ponto.
200Pacotes do sistema, em JSON: ["poppler-utils"]. Sem ele, valem os systemPackages do cube.json (também quando o formulário traz language e command). Nome fora da lista, 422 unsupported_system_package.
Liga o projeto a um banco de dados da conta: a string de conexão entra como variável de ambiente antes da primeira subida.
^[0-9A-HJKMNP-TV-Z]{26}$Resposta
Projeto criado, instalando as dependências.

