← Portfólio

Produto digital · estudo de caso

Qode

Um estúdio gratuito de QR Code e código de barras que roda inteiro no navegador: códigos estáticos que não expiram, com Pix, logo, PDF vetorial, lote, etiquetas e leitor.

TipoProduto próprio
PapelConcepção, design, desenvolvimento e operação
PeríodoDez/2025 · em evolução
EstadoEm manutenção
TecnologiasReact 19 · TypeScript · Vite · Tailwind CSS 4 · qrcode · JsBarcode · jsQR · fflate · Vitest · Vercel

O projeto em poucas palavras

O Qode é um estúdio gratuito para criar QR Codes e códigos de barras prontos para impressão. Tudo acontece no próprio navegador: o conteúdo, o logo e as listas de códigos não são enviados a nenhum servidor, não há cadastro e não há assinatura. Os códigos são estáticos, ou seja, apontam diretamente para o que foi codificado e funcionam para sempre.

O site está no ar em qodefree.com, com seis idiomas (português, inglês, espanhol, francês, chinês e hindi), tema claro e escuro e instalação como aplicativo.

Estúdio de geração do Qode com um QR Code azul de módulos em pontos, logo no centro e legenda, ao lado dos campos de conteúdo e aparência
O estúdio de geração: conteúdo, aparência e exportação na mesma tela, com a pré-visualização sempre à vista.Ampliar imagem ↗

O ponto de partida

A ideia nasceu de uma experiência ruim: um lote de materiais impressos com QR Codes criados num site gratuito que aparecia bem posicionado no buscador. Os códigos eram, na verdade, links “dinâmicos” controlados pelo serviço. Algumas semanas depois, pararam de funcionar, e reativá-los exigia uma assinatura mensal. O material impresso já estava pago e não tinha mais utilidade.

Daí vieram dois objetivos. O primeiro, garantir que um código gerado ali nunca dependa de um serviço que possa sair do ar ou mudar de preço. O segundo, ir além do “gerar e baixar”: quem imprime etiquetas, cardápios, cobranças e embalagens precisa de tamanho em milímetros, arquivo vetorial, lote, validação do conteúdo e a certeza de que o código realmente lê antes de ir para a gráfica.

Um estúdio para cada tipo de código

QR Codes para o que a pessoa realmente precisa codificar

O gerador oferece onze modelos de conteúdo, cada um com seus próprios campos e validações: link, texto, Wi-Fi, contato (vCard), e-mail, SMS, telefone, WhatsApp, localização, evento de calendário e Pix. Em vez de pedir que a pessoa monte à mão uma string como WIFI:T:WPA;S:rede;P:senha;;, o Qode monta o formato certo a partir de campos simples (nome da rede, senha, tipo de segurança, rede oculta).

O modelo de Pix gera o BR Code estático, no padrão do Banco Central, com chave, nome do recebedor, cidade, valor opcional, identificador e descrição, e calcula o CRC do payload. Um aviso lembra de fazer um pagamento de teste antes de imprimir, já que nome e cidade precisam corresponder à conta.

Aparência sem perder a leitura

Cores do código, do fundo e dos cantos, fundo transparente, módulos quadrados, arredondados ou em pontos, cantos quadrados, arredondados ou circulares, margem de silêncio ajustável e quatro níveis de correção de erro (7%, 15%, 25% e 30%). Um medidor mostra quanto da capacidade do código o conteúdo está ocupando.

É possível colocar um logo no centro e uma legenda impressa abaixo do código, dizendo o que acontece ao escanear. Quando há logo, a correção de erros sobe automaticamente para o nível alto, e o estúdio avisa a pessoa sobre isso.

Controles de aparência do Qode: estilo dos módulos e dos cantos, correção de erros, margem, logo no centro e aviso sobre a correção de erros alta
Aparência: estilo dos módulos e dos cantos, correção de erros, margem, logo e legenda.Ampliar imagem ↗

Teste de leitura automático

A cada alteração, o Qode decodifica o próprio código com o jsQR e mostra, ao lado da pré-visualização, se a leitura passou. O estúdio também alerta sobre contraste insuficiente, cores invertidas e margem curta: os erros mais comuns de quem personaliza um QR Code e só descobre o problema com o material já impresso.

Códigos de barras com validação

O gerador de barras cobre treze formatos: EAN-13, EAN-8, UPC-A, UPC-E, Code 128, GS1-128, ITF-14, ITF, Code 39, Code 93, Codabar, MSI e Pharmacode. Cada formato valida o que é digitado e explica o problema, e um dígito verificador errado pode ser corrigido com um clique. Largura da barra, altura, margem, tamanho, posição e alinhamento do texto são ajustáveis.

Para EAN, o Qode gera um código de teste válido, com escolha do prefixo por país (como o do Brasil, 789–790) ou da faixa de uso interno, e traz um aviso sobre o licenciamento da GS1: códigos aleatórios servem para testes e uso interno, mas quem vende em lojas e marketplaces precisa licenciar o prefixo da empresa. Uma calculadora de dígito verificador atende EAN-8, EAN-13, UPC-A, GTIN-14 e SSCC.

Gerador de código de barras do Qode no formato EAN-13, com seleção de país, aviso sobre a licença da GS1 e pré-visualização do código
Código de barras EAN-13 com prefixo por país e aviso sobre a licença da GS1.Ampliar imagem ↗

Exportação pensada para imprimir

A saída é dimensionada em milímetros e em resolução de 72 a 600 DPI, e o Qode mostra o tamanho impresso e a dimensão da imagem em pixels antes de baixar. Os formatos são PNG (com metadado de DPI), JPEG, WebP, SVG e PDF, sendo os dois últimos vetoriais, ideais para qualquer tamanho. Também é possível copiar a imagem, compartilhar pelo recurso nativo do aparelho e copiar um link do design, que reabre o gerador com a mesma configuração.

Os códigos exportados ficam num histórico, com favoritos, que é guardado apenas no navegador. Os logos não são armazenados.

Histórico de códigos recentes do Qode, com o código exportado, botões para restaurar, favoritar e remover, e as notas de transparência do projeto
O histórico fica apenas neste navegador, com opção de favoritar e restaurar.Ampliar imagem ↗

Geração em lote e folhas de etiquetas

A página de lote cria centenas de códigos de uma vez a partir de uma lista (um valor por linha), de um arquivo CSV ou TXT, ou de uma sequência numerada. A saída pode ser um ZIP com um arquivo por código ou um PDF de folhas A4 de etiquetas, com modelos Avery (L7160, L7159, L7163 e L7651), grade 4 × 6 e uma grade personalizada. O Qode informa quantas etiquetas cabem por página e lembra de imprimir em 100%, nunca em “ajustar à página”. Os lotes usam o estilo salvo no gerador, logo incluído, e podem trazer o valor impresso abaixo de cada código.

Página de geração em lote do Qode, com uma lista de doze valores, a pré-visualização dos códigos e as opções de folha de etiquetas Avery
Lote: da lista à folha de etiquetas A4 pronta para imprimir.Ampliar imagem ↗

Leitor para conferir antes de distribuir

O leitor abre a câmera ou uma imagem e mostra o conteúdo lido, com opções de copiar, abrir o link e editar no gerador, além de um lembrete para conferir o endereço antes de abrir. A leitura de QR Codes funciona em qualquer navegador; a de códigos de barras depende do suporte ao BarcodeDetector, e a página avisa quando o navegador não o oferece. As imagens são processadas no aparelho.

Leitor do Qode com o resultado da leitura de um QR Code, mostrando o endereço lido e os botões copiar, abrir link e editar no gerador
Leitor: confere o código impresso e permite abrir o gerador com o mesmo conteúdo.Ampliar imagem ↗

Guias, missão e apoio

Duas páginas de guia explicam, em linguagem direta, onde usar cada tipo de código e as boas práticas: QR Codes em embalagens, cardápios, eventos, pagamentos e suporte; códigos de barras em varejo, estoque, logística e saúde. Uma página sobre a missão conta por que o projeto existe e como a ajuda é usada, e uma página de apoio reúne Pix, criptomoedas, Buy Me a Coffee, PayPal, Patreon e Stripe.

:::

Design e decisões

Uma única cena, vários formatos

Cada código é construído primeiro como uma pequena “cena” vetorial. Dessa cena saem a pré-visualização em SVG, o canvas dos formatos de imagem, o arquivo SVG e o PDF, gerado por um escritor de PDF enxuto, escrito para o projeto, que desenha módulos e barras como vetores. Por isso o arquivo baixado é sempre idêntico ao que aparece na tela. No canvas, as bordas se alinham a pixels inteiros e os módulos dos códigos de barras recebem largura inteira, para que a impressão fique nítida.

As matrizes de QR vêm da biblioteca qrcode, e as codificações de barras, do JsBarcode, com o layout reproduzido exatamente como o do renderizador original e coberto por um teste de paridade.

Tudo no navegador

Os códigos, o conteúdo, os logos e as listas em lote são processados localmente. O tráfego de rede se resume ao carregamento do site e à contagem anônima e sem cookies de páginas vistas, feita com o Vercel Web Analytics. O decodificador jsQR só é carregado quando necessário, e o ZIP do lote usa a fflate. O site é um aplicativo instalável, com service worker, que continua funcionando sem conexão.

Interface sóbria e acessível

A estética é sóbria, de papel e obsidiana, pensada para foco: pouca decoração, controles agrupados por tarefa e a pré-visualização sempre à vista. O tema pode seguir o sistema ou ser claro ou escuro, a navegação funciona por teclado e leitor de tela, e a interface se adapta ao celular. Os textos existem nos seis idiomas, com a mesma estrutura.

Honestidade como parte do produto

A página principal traz uma nota de transparência que explica por que o Qode é gratuito e alerta sobre geradores que escondem uma assinatura nas entrelinhas. Gerar códigos estáticos não é um detalhe técnico: é o que garante que o material impresso continue funcionando. :::

O que fiz

Concebi o produto, desenhei a interface e desenvolvi tudo: o estúdio de QR Codes e de códigos de barras, os modelos de conteúdo (inclusive o Pix), o teste de leitura, os motores de exportação em PNG, JPEG, WebP, SVG e PDF, o lote com folhas de etiquetas, o leitor, o histórico, a tradução para seis idiomas e o aplicativo instalável. Também escrevi os guias e os textos da missão e configurei a publicação na Vercel, com cabeçalhos de segurança como a política de conteúdo (CSP).

Onde está hoje

O Qode está no ar em qodefree.com e atende a quem trabalha com material impresso, cardápios, cobranças por Pix, etiquetas de estoque e identificação de produtos. A qualidade é acompanhada por testes automatizados de Pix, QR Codes, códigos de barras, dígitos verificadores, CSV, arquivos, modelos de conteúdo e lógica do aplicativo, mais análise estática e verificação de tipos em integração contínua.

O projeto é mantido por uma pessoa só, nas horas vagas, e segue apoiado por doações voluntárias, sem anúncios.

O que guiou as decisões

O código estático é mais simples e mais honesto que o dinâmico: não exige servidor, não cobra para continuar funcionando e não pode ser desativado. A complexidade do produto ficou onde quem usa realmente precisa dela: em verificar a leitura, validar formatos, dimensionar em milímetros e preparar a impressão.

Também aprendi que gerar o arquivo a partir de uma única fonte, a cena vetorial, elimina uma classe inteira de problemas: o que se vê na tela é exatamente o que vai para o PDF, o SVG e a gráfica.

Uma ideia em movimento?

Vamos transformar a próxima pergunta em algo que funciona.

Conversar sobre um projeto ↗