Skip to content

gabpaesschulz/freedom-calc

Repository files navigation

FreedomCalc
Planejamento Financeiro para Devs

🚀 Acesse a Aplicação Online

Next.js React TypeScript License


Sobre o Projeto

FreedomCalc é um gerenciador financeiro pessoal focado em liberdade financeira, privacidade e projeção de patrimônio. Criado por devs, para devs que querem parar de anotar centavos e começar a construir patrimônio.

Todos os dados ficam 100% no navegador — zero servidores, zero rastreamento. Você tem controle total sobre suas informações, com criptografia opcional AES-256 via localStorage.

Por que usar?

  • Você quer saber quando vai atingir a independência financeira.
  • Você quer um app que respeite sua privacidade (nenhum dado sai do seu navegador).
  • Você quer simular cenários de investimento com juros compostos reais.
  • Você é dev e quer um projeto open source de qualidade para estudar ou contribuir.

Stack Tecnológica

Tecnologia Uso
Next.js 16 Framework React com App Router, SSR e otimizações automáticas
Zustand Gerenciamento de estado leve e performático
Recharts Gráficos interativos (alocação de portfólio, evolução patrimonial)
Shadcn/ui Componentes acessíveis baseados em Radix UI + Tailwind CSS
Tailwind CSS 4 Estilização utility-first com design system consistente
TypeScript 5 Tipagem estática em toda a codebase
Vitest Testes unitários rápidos com suporte nativo a ESM
CryptoJS Criptografia AES-256 para dados sensíveis no localStorage

Funcionalidades Chave

Criptografia & Privacidade

  • AES-256 para criptografar dados no localStorage
  • Tela de bloqueio com PIN — proteja o acesso ao app
  • Modo Privacidade — pressione P para borrar todos os valores na tela
  • Zero servidores — seus dados nunca saem do navegador

Projeção & Simulação

  • Simulador de Investimentos com juros compostos e aportes mensais
  • Calculadora de Liberdade Financeira — descubra quando atingir o FIRE
  • Gráfico de evolução patrimonial com cenários pessimista, base e otimista
  • Custo de oportunidade — veja o impacto de cada despesa no longo prazo

Gestão Financeira

  • Dashboard completo com resumo de salário, despesas e superávit
  • Cenários de despesas (atual vs. ideal) com abas comparativas
  • Agenda de pagamentos com datas de vencimento
  • Metas por categoria com acompanhamento visual
  • Alocação de portfólio com gráfico de pizza interativo

PWA Ready

  • Interface responsiva e otimizada para mobile
  • Pode ser instalada como app via navegador
  • Funciona offline com dados em localStorage

Developer Experience

  • Command Palette (Ctrl+K) para navegação rápida
  • Testes unitários com Vitest
  • Tema escuro nativo com suporte a light mode
  • Smart Input para adicionar despesas rapidamente

Como Rodar

Pré-requisitos

  • Node.js >= 18
  • npm >= 9 (ou yarn / pnpm / bun)

Instalação

# 1. Clone o repositório
git clone https://github.com/gabpaesschulz/freedomcalc.git
cd freedomcalc

# 2. Instale as dependências
npm install

# 3. Inicie o servidor de desenvolvimento
npm run dev

Abra http://localhost:3000 no navegador.

Scripts Disponíveis

Comando Descrição
npm run dev Servidor de desenvolvimento com hot reload
npm run build Build de produção otimizada
npm run start Inicia o servidor de produção
npm run lint Executa o ESLint
npm test Roda os testes em modo watch
npm run test:run Roda os testes uma vez (CI)

Build de Produção

npm run build
npm run start

A build utiliza SWC para minificação automática e otimizações do Next.js 16 (tree-shaking, code splitting, image optimization).


Estrutura do Projeto

src/
├── app/
│   ├── layout.tsx          # Layout raiz (SEO, fonts, providers)
│   ├── page.tsx            # Landing page
│   ├── globals.css         # Estilos globais (Tailwind)
│   └── (app)/
│       ├── layout.tsx      # Layout autenticado (Header, LockScreen)
│       ├── dashboard/      # Dashboard de despesas
│       └── portfolio/      # Portfólio e simulações
├── components/
│   ├── ui/                 # Componentes Shadcn/ui
│   └── *.tsx               # Componentes de negócio
├── hooks/                  # Custom hooks (auth, finance, privacy, theme)
├── lib/                    # Utilitários e encrypted storage
└── __tests__/              # Testes unitários

Licença

Este projeto é open source e está disponível sob a Licença MIT.


Feito com dedicação para a comunidade dev brasileira.

About

Planejamento Financeiro para Devs. Focado em Liberdade Financeira (FIRE), Privacidade (100% LocalStorage) e Projeção de Patrimônio.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors