@cee.bio/cli

CLI pra criar seu profile cee.bio com código — Vite dev local, cee push publica.

npx create-cee-profile@latest meu-perfil
cd meu-perfil
npm install
npm run login    # vincula sua conta cee.bio
npm run dev      # localhost:5173 com HMR
npm run push     # publica em https://cee.bio/seu-user

Importante: use npm run em vez de npx cee. Existe um pacote npm não-relacionado chamado cee que sequestra npx cee. O scaffold adiciona @cee.bio/cli como devDependency, então npm run login resolve corretamente. Alternativa global: npx @cee.bio/cli login.

Comandos

| Comando | O que faz | | ------------------- | ----------------------------------------------- | | cee init [dir] | Cria um novo projeto (também: create-cee-profile) | | cee login | Vincula esta máquina à sua conta cee.bio | | cee logout | Revoga o token desta máquina | | cee whoami | Mostra a conta logada | | cee dev | Preview live em localhost:5173 (Vite + HMR) | | cee push | Publica no seu profile (build + upload) | | cee push --draft | Envia sem ativar devMode | | cee pull | Baixa o source atual do servidor |

Comandos novos (0.2.0)

Requerem @cee.bio/runtime@^0.2.0 instalado no projeto — os comandos widgets e preview introspectam/renderizam os componentes do runtime novo. Projetos criados por cee init já vêm com a versão certa.

| Comando | O que faz | | ------------------- | ----------------------------------------------------------- | | cee widgets | Lista os widgets do runtime e suas props (Discord/YouTube/GitHub/Roblox/Steam/Valorant/Stack/Custom) | | cee preview | Render estático do profile.tsx em .cee/preview (sem subir Vite) | | cee watch | Observa o source e dispara cee push --draft automático em cada mudança | | cee status | Estado do profile remoto: última publicação, devMode, tamanho do bundle | | cee doctor | Sanity-check do ambiente (node, CLI, runtime, credenciais, API) | | cee profile | Abre o profile público no browser (--copy copia a URL) |

Hooks de tema (0.4.0)

Os scaffolds agora vêm com @cee.bio/runtime ^0.4.0, que expõe helpers pra resolver as cores/blur/borda/radius do user com fallback safe:

• useTheme() — cores+fonte resolvidas (nunca null).
• useUserCardStyle(overrides?) — style do card (fill/border/shadow/padding).
• useUserBackground(overrides?) — style da página inteira (cor/imagem/blur).
• useUserAvatarStyle({ size?, shape? }) — { src, style } do avatar.
• useUserBadgeContainerStyle(), useUserMusicStyle(), useUserTooltipStyle().
• withUserDefaults(Component, mapping) — HOC que injeta defaults do user.
• resolveColor(value, fb, op?) / buildGradient(c1, c2, ang, op?) — utils.

Regra de ouro: valor do user (não-null) >>> override do autor >>> default do helper >>> hard fallback. Você define o layout, o user manda nas cores. Veja templates/default/README.md e src/profile.tsx pra um exemplo paste-ready.

Auth

cee login abre o cee.bio com um pairing code. Você confirma logado no browser, o CLI recebe um token long-lived guardado em ~/.cee/credentials (chmod 600). Múltiplas máquinas = múltiplos tokens; cada um revogável independente via cee logout ou no dashboard.

Override de API (pra dev contra um backend local): CEE_API_URL=http://localhost:3001 cee login.

Como funciona

1. Você escreve src/profile.tsx usando @cee.bio/runtime (componentes: <Avatar/>, <SocialLinks/>, <Card/>, <Music/>, etc).
2. cee dev roda Vite local com mock data — você itera no design.
3. cee push builda em modo lib (dist/profile.js, formato ESM single-file) e envia source + bundle pro backend. O servidor cee.bio executa esse bundle quando renderiza seu profile público.

Docs completas

Cada componente, prop e data binding: https://cee.bio/devs