Começando

Este guia leva você do zero até criar sua primeira issue em menos de 5 minutos.

Criar conta

Acesse tasks.cloudface.tech e clique em Criar conta. Preencha nome, e-mail e senha. Após o registro, você é redirecionado direto para o app — sem confirmar e-mail em ambiente de demonstração.

Se estiver rodando self-hosted, acesse o endereço configurado na sua instalação.

Primeiro acesso

No primeiro login, o sistema cria automaticamente:

1. Uma organização com o seu nome (ex: "Gabriel Mowses")
2. Um workspace padrão chamado "Meu workspace"
3. Você como owner de ambos

Você já está pronto para criar projetos.

Criando o primeiro projeto

1. No sidebar esquerdo, clique em + Novo projeto
2. Preencha:
   • Nome: ex. CloudTasks
   • Identificador: sequência curta de letras maiúsculas usada nas chaves das issues (ex. CT). Gerado automaticamente a partir do nome, mas pode ser editado
   • Cor: escolha uma cor para o ícone do projeto no sidebar
   • Lead: responsável principal pelo projeto (opcional)
3. Clique em Criar projeto

O projeto é criado com um conjunto de status padrão: Backlog, A fazer, Em progresso, Em revisão, Concluído.

Criando a primeira issue

Com o projeto aberto:

1. Clique em + Nova issue ou pressione C (atalho global)
2. Preencha o título (obrigatório)
3. Opcionalmente:
   • Adicione uma descrição em Markdown
   • Defina tipo (Tarefa, Bug, História, Épico)
   • Defina prioridade (Urgente, Alta, Média, Baixa)
   • Atribua a um membro
   • Adicione etiquetas
   • Defina data de início e prazo
4. Clique em Criar

A issue recebe automaticamente uma chave no formato CT-1, CT-2, etc.

Entendendo o sidebar

O sidebar está dividido em seções:

[Logo CloudTasks]
[Seletor de organização]  ← troca entre suas orgs
─────────────────────────
[Seletor de workspace]    ← troca entre workspaces da org
─────────────────────────
  Minha conta
  Issues atribuídas a mim
─────────────────────────
  Projetos
  ├── Frontend          ← projetos do workspace atual
  ├── Backend
  └── + Novo projeto
─────────────────────────
  Configurações

Seletor de organização: clique no nome da org no topo para ver todas as organizações das quais você é membro e trocar entre elas.

Seletor de workspace: abaixo da org, mostra o workspace atual. Clique para trocar de workspace dentro da mesma organização.

Busca rápida

Pressione Cmd+K (macOS) ou Ctrl+K (Windows/Linux) em qualquer tela para abrir a paleta de busca. Digite qualquer coisa — título, chave da issue (ex. CT-1), nome de projeto — e os resultados aparecem em tempo real com busca semântica.

Próximos passos

• Conceitos fundamentais — entenda como tudo se encaixa
• Convidar membros — adicionar o time à organização
• Customizar status — adaptar o workflow ao seu processo
• Busca com IA — entender como a busca semântica funciona