NevextNevext

Repositório

nevext / validate-html

Pra que serve

`Validate` é uma pequena plataforma web para permitir que colegas validem rapidamente sites uns dos outros e criem links compartilháveis com parâmetros predefinidos. O sistema foi desenvolvido para a Github Week e serve como ferramenta de colaboração e feedback.

Em números

  • estrelas

    0

    As curtidas do GitHub: quanta gente marcou que gostou.

  • forks

    0

    Cópias que outras pessoas fizeram pra mexer à vontade.

  • issues abertas

    0

    Pedidos e problemas que alguém avisou e ainda não foram resolvidos.

  • última mudança

    há 4 meses

    Quando o código mudou pela última vez. Recente quer dizer projeto vivo.

Feito com

  • TypeScript 45%
  • CSS 25%
  • JavaScript 20%
  • HTML 9%

Levar pro seu computador

Três jeitos, do mais fácil pro mais "de verdade".

O que tem dentro

A pasta principal do projeto, começando pelo que vale a pena entender.

Ver os outros 6

Últimas versões salvas

Cada versão salva é um commit: uma foto do projeto com uma frase dizendo o que mudou.

Está bem apresentado?

O que um repositório precisa pra quem chega entender e conseguir usar.

6 de 9 itens

Dá pra melhorar

  • As versões foram salvas ao longo do tempoSalve versões (commits) a cada passo, e não tudo de uma vez no fim. O histórico é a prova de que foi você que construiu.
  • Tem uma licençaAdicione um arquivo LICENSE (a MIT é a mais comum). Ele diz o que os outros podem fazer com o seu código.
  • Tem tópicos (tags) no GitHubAdicione tópicos como "react" ou "jogo" no About do GitHub. Eles fazem o projeto ser achado.
  • Tem um README que apresenta o projeto
  • O README explica como rodar
  • Tem uma descrição curta no GitHub
  • Tem uma demonstração
  • Tem um .gitignore
  • Não guarda pastas de dependências nem senhas

README

Escrito pelo autor, quase sempre em inglês. É onde ele explica o projeto e como instalar.

Validate

Plataforma onde um usuário cria um projeto, gera um link único (/p/[slug]) e compartilha com outras pessoas para que testem e validem seu site, app, vídeo, documento ou executável — respondendo um checklist de avaliação (design, UX, bugs) e deixando comentários. O dono do projeto vê os resultados num dashboard.

Migrado de um protótipo estático em HTML/CSS/JS (preservado em legacy-static/) para Next.js (App Router + TypeScript).

Stack

  • Next.js 16 (App Router, TypeScript)
  • CSS Modules para estilo (identidade visual original portada 1:1: fundo claro, tipografia bold extrema KazerFluro + Poppins, estilo editorial preto/branco)
  • Firebase Authentication (email/senha) — só quem cria projetos precisa de conta; quem responde o checklist em /p/[slug] não precisa de login
  • Cloud Firestore — projetos (projects) e validações (validations) são dados reais, não mockados

Configuração

Crie um .env.local (veja .env.example) com as credenciais do seu projeto Firebase (Configurações do projeto → Geral → apps web). As regras do Firestore ainda estão em modo de teste — antes de qualquer uso público real, é preciso escrever regras adequadas (ver aviso no CHANGELOG.md).

Estrutura

app/            rotas (App Router): home, /create, /p/[slug], /dashboard, /login, /signup
components/     componentes React + seus CSS Modules
lib/            firebase.ts (config), firestore.ts (projects/validations), auth-actions.ts
public/         imagens e ícones estáticos
legacy-static/  versão original em HTML/CSS/JS, preservada como referência

Rodando localmente

npm install
npm run dev

Abra http://localhost:3000.

Veja o CHANGELOG.md para o histórico de mudanças.

Comentários da comunidade

Usou, travou em algo, achou uma dica? Conta aqui pra quem vier depois.

0/1000

Ninguém comentou ainda. Seja o primeiro.