Criar algo do zero é sempre um desafio, mas também uma oportunidade de dar vida a soluções que você gostaria de ver no mundo. Foi assim que nasceu o Cortesia, uma plataforma de fidelidade digital, simples e eficiente, pensada para facilitar a vida de pequenos negócios. E o melhor? Desenvolvi tudo em apenas duas semanas, entre compromissos e momentos de inspiração. Vou compartilhar aqui como fiz isso, incluindo as tecnologias que ajudaram a transformar essa ideia em realidade.
O Problema: Fidelidade Analógica
Em 2016, uma sorveteria que eu frequentava semanalmente tinha um daqueles cartões físicos de fidelidade: consuma 10, ganhe 1. Simples, mas problemático – perdia-se o cartão ou ele ficava esquecido na carteira. Quando sugeri algo digital a outra empresa, ouvi que seria “complicado demais”.
Corta para 2024, e muitos negócios ainda enfrentam as mesmas dificuldades. Ou se apegam a cartões físicos, ou investem em sistemas digitais tão caros e confusos que acabam não sendo viáveis. Foi pensando nisso que criei o Cortesia: uma plataforma que leva simplicidade para o cliente e praticidade para o negócio.
O Que É o Cortesia?
O Cortesia é uma plataforma de fidelidade digital acessível e direta. O cliente acumula pontos usando um código simples, como o número de telefone. O estabelecimento gerencia tudo por um dashboard intuitivo, sem precisar de tutoriais complexos ou suporte técnico constante.
O objetivo? Democratizar programas de pontos e facilitar o dia a dia de empreendedores.
Tecnologias Utilizadas (Stack)
Front-end
O projeto foi dividido em três áreas principais:
- App: para clientes acumularem pontos e resgatarem recompensas.
- Admin: dashboard para estabelecimentos gerenciarem o programa de fidelidade.
- Blog: para compartilhar atualizações e conteúdos sobre fidelização.
Ferramentas-chave:
- Vite: o coração do build, garantindo tempo de desenvolvimento mais rápido e visualização instantânea.
- TypeScript: para reduzir bugs e trazer mais confiança no código.
- React Router e Generouted: para rotas dinâmicas e organizadas.
- Tailwind CSS e Shadcn UI: estilização eficiente com componentes reutilizáveis.
- TanStack Query: para consultas otimizadas e gerenciamento de dados sem complicação.
- React Hook Form e Zod: validação de formulários que funciona desde o primeiro teste.
- Lucide: ícones simples e customizáveis para uma experiência mais agradável.
O blog, construído com Astro, foi otimizado para SEO e carregamento rápido, com suporte a Markdown/MDX, facilitando a criação de conteúdo.
Back-end
No servidor, escolhi uma stack ágil e segura:
- Hono: framework minimalista e poderoso.
- Lucia Auth: autenticação fluida, com suporte a Google OAuth.
- Drizzle ORM: gerenciamento de banco de dados confiável e fortemente tipado.
- Zod: validação robusta para inputs e queries.
- neverthrow: para tratamento de erros elegante e previsível.
O banco de dados começou como SQLite no Cloudflare D1, mas migrei para Turso (LibSQL) por conta da performance superior. Graças ao Drizzle, a transição foi fácil e sem dores de cabeça.
Infraestrutura
- Cloudflare Pages para o front-end.
- Cloudflare Workers para o back-end.
- Bun como runtime, garantindo execução rápida e gerenciamento de pacotes eficiente.
As interfaces foram criadas com ajuda de inteligência artificial, utilizando v0.dev e bolt.new, agilizando a prototipagem e garantindo designs funcionais.
Por Que o Cortesia Faz Sentido?
Se você frequenta lugares que ainda usam cartões de fidelidade físicos ou é dono de um negócio que quer oferecer um programa de pontos moderno, o Cortesia é a solução ideal. É rápido de implementar e simples de usar. Se você é dono de um negócio, acesse admin.cortesia.app e veja como é fácil gerenciar seu programa de fidelidade. Se você é um cliente final, acesse cortesia.app e comece a acumular pontos.
Gostou do artigo? Quer trocar ideias sobre tech ou micro-saas? Me chame no X ou no LinkedIn.