O Muvuca
O Muvuca reúne links, prompts e componentes de código em uma biblioteca visual,
rápida e fácil de manter. Você pode importar os favoritos do navegador, organizar
o acervo em até seis níveis de tags e pesquisar por título, conteúdo, descrição ou
domínio.
O que você encontra por aqui
- Uma biblioteca só: links, prompts e snippets lado a lado, cada tipo com uma
apresentação própria.
- Tags que preservam contexto: hierarquia com rollup automático, sem itens
duplicados nos resultados.
- Busca imediata: pesquisa full-text combinada com filtros e ordenação.
- Importação sem retrabalho: transforme a exportação de favoritos do navegador
em tags e links, com prévia antes de confirmar.
- Portabilidade: exporte o acervo em JSON ou HTML Bookmarks e restaure backups
quando precisar.
- Feito para qualquer tela: interface responsiva com temas claro, escuro e do
sistema.
Comece em poucos minutos
Pré-requisitos
1. Baixe o projeto
git clone https://github.com/kayodante/muvuca.git
cd muvuca
pnpm install --frozen-lockfile
2. Inicie o Supabase local
supabase start
cp .env.example .env.local
Copie a Publishable key exibida por supabase start para
NEXT_PUBLIC_SUPABASE_PUBLISHABLE_KEY em .env.local. Os demais valores já
apontam para o ambiente local.
3. Rode o Muvuca
pnpm dev
Acesse localhost:3000 e entre com
[email protected] e a senha muvuca-dev-local, a conta que
supabase/seed.sql recria a cada supabase db reset. O email de
recuperação de senha chega no Mailpit local;
nenhum email é enviado de verdade.
Para encerrar o ambiente local:
supabase stop
Usando seu próprio Supabase
Para usar o Muvuca com um projeto Supabase na nuvem ou self-hosted:
-
Crie o projeto e aplique as migrations:
supabase link --project-ref <seu-project-ref>
supabase db push
-
Preencha as três variáveis de .env.local com os dados do projeto.
-
Crie o primeiro usuário em Authentication → Users → Add user no painel do
Supabase, com email e senha (mínimo de 12 caracteres).
-
Faça o build e o deploy seguindo o guia de deploy.
O formulário de login não cria novas contas: o Muvuca foi pensado para um deploy
pessoal, autenticado por email e senha. A senha esquecida é redefinida por um
link enviado ao email em Esqueci a senha.
Variáveis de ambiente
| Variável | Uso |
|---|
NEXT_PUBLIC_SUPABASE_URL | URL do projeto Supabase |
NEXT_PUBLIC_SUPABASE_PUBLISHABLE_KEY | Chave publicável (sb_publishable_...) |
NEXT_PUBLIC_APP_URL | URL pública da aplicação |
Todas são públicas por design. O Muvuca não usa service_role nem outra chave
administrativa no servidor da aplicação.
Comandos úteis
| Comando | Descrição |
|---|
pnpm dev | Inicia o servidor de desenvolvimento |
pnpm test | Executa os testes com Vitest |
pnpm test:e2e | Executa os testes end-to-end com Playwright |
supabase test db | Executa os testes de banco e RLS com pgTAP |
pnpm check | Executa lint, typecheck, testes e verificação de formato |
pnpm build | Gera o build de produção |
Estrutura do repositório
app/ Rotas do Next.js App Router
components/ Componentes React por área de produto
lib/
actions/ Server Actions
database/queries/ Consultas tipadas ao Supabase
validation/ Schemas Zod
security/ Headers, CSP, logs e redirects
metadata/ Pipeline protegido de prévias de links
supabase/ Clientes para browser, servidor e proxy
supabase/
migrations/ Schema versionado em SQL
tests/ Testes pgTAP
e2e/ Testes Playwright
docs/ Arquitetura e deploy
proxy.ts Sessão Supabase e nonce CSP por request
Sobre o projeto
O Muvuca nasceu como estudo de caso de desenvolvimento assistido por IA, com foco
em arquitetura, segurança e fluxo de trabalho com agentes. O projeto usa Next.js,
React, TypeScript e Supabase, com RLS deny-by-default e validação em profundidade.
Licença
Distribuído sob a licença MIT.
