Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.testly.com.br/llms.txt

Use this file to discover all available pages before exploring further.

​
Por que duas chaves?

Toda organização no Testly tem dois pares de chave + ambiente:
ChaveFormatoAmbiente
Produçãotk_live_...Eventos contam nas métricas, uso e marketing
Desenvolvimentotk_test_...Eventos são isolados — não afetam métricas nem uso
Isso garante que você nunca polui seus dados reais enquanto itera localmente.

​
Como ativar o Dev Mode

No dashboard, clique no toggle no rodapé da sidebar (ícone de chave ou switch). Na primeira ativação, um modal explica o que muda. Você também pode ativar pelo header no mobile. O que muda visualmente:
  • Strip entre o header e o conteúdo fica âmbar (“Dev Mode Ativo”)
  • Toggle na sidebar fica âmbar
  • Settings → Chave de API mostra a tk_test_... em âmbar

​
Fluxo completo de desenvolvimento

1. Ative o Dev Mode no dashboard
2. Crie um experimento — ele fica com is_test=true, invisível no modo Produção
3. Copie a chave tk_test_... em Settings → Chave de API → aba Desenvolvimento
4. Use essa chave no seu ambiente local:
.env.local
# Sobrescreve .env localmente — não commite este arquivo
VITE_TESTLY_API_KEY=tk_test_...
App.tsx
<TestlyProvider apiKey={import.meta.env.VITE_TESTLY_API_KEY}>

5. Implemente o useExperiment no componente, teste localmente
6. Veja as impressões chegando no dashboard (em Dev Mode)
7. Quando pronto: toggle de volta para Produção
8. Troque a chave por tk_live_... no .env de produção (Vercel, etc.)
Use .env com a chave de produção e .env.local com a chave de dev. O .env.local sobrescreve localmente e não deve ser commitado. Assim a CI/CD usa produção automaticamente.

​
Isolamento garantido pelo backend

O isolamento não é só visual — é aplicado na camada de banco de dados:
  • get-variant: uma chave tk_test_ só resolve experimentos com is_test=true. É impossível acessar experimentos de produção com a chave de dev, e vice-versa.
  • Eventos: eventos enviados com tk_test_ são marcados com is_test=true e não afetam experiment_stats, experiment_daily_stats, organization_monthly_usage nem o pipeline de emails de lifecycle.
  • Limite do plano: experimentos de dev não contam para o limite de experimentos ativos. Você pode criar quantos quiser independente do plano.

​
Experimentos limitados no plano gratuito?

O plano gratuito limita 1 experimento de produção ativo. Experimentos em Dev Mode são ilimitados — você pode criar e testar à vontade sem custo adicional.

​
FAQ

Não. A chave tk_test_ só resolve experimentos com is_test=true. Se você deployar com ela, useExperiment sempre retorna variant: null para experimentos de produção.Solução: use tk_live_... no deploy de produção.
Causa mais comum: a chave no TestlyProvider é tk_live_ mas o experimento foi criado em Dev Mode (is_test=true).Checklist:
  1. Confirme que o Dev Mode está ativo no dashboard
  2. Copie a chave tk_test_... em Settings → Chave de API → aba Desenvolvimento
  3. Use essa chave no seu .env.local
  4. Reinicie o servidor de desenvolvimento
Use o botão “Promover para Produção” no cabeçalho do experimento (visível quando você está em Dev Mode). Isso cria uma cópia com is_test=false — pronto para usar com a chave de produção.O experimento original em dev continua existindo para referência.
Sim. Telemetria Global e Conversão Média filtram por is_test conforme o toggle:
  • Produção: mostra apenas dados de experimentos reais
  • Dev Mode: mostra apenas dados de testes
Trocar o toggle não afeta os dados — apenas a visualização.
Settings → Chave de API → aba Desenvolvimento → botão “Rotacionar”. A chave antiga invalida imediatamente. Atualize o .env.local e reinicie o servidor.

​
Próximos Passos

Quickstart

Implemente seu primeiro teste A/B em 5 minutos

Debugging

Logs e troubleshooting do SDK