Ember Cash

Las finanzas del hogar, claras y compartidas. Gastos, deudas, ahorros y suscripciones en un solo lugar, para ti o para dos.

Demo · Características · Empezar · Arquitectura

---

Qué es

Ember Cash es una app web para llevar las cuentas de la casa sin hojas de cálculo. Cada persona tiene su espacio personal y, si quiere, comparte un hogar con su pareja o con quien viva: los gastos compartidos se reparten solos y el balance de quién debe a quién siempre está al día.

Está pensada para uso real en Colombia: maneja pesos (COP) y dólares (USD) a la vez, con la tasa de cambio oficial del día.

Características

Transacciones	Ingresos, gastos y transferencias entre cuentas, con categorías, notas y deshacer al borrar.
Hogar compartido	Gastos a partes iguales, balance entre miembros y liquidación total o parcial. Quien se une después no debe lo anterior.
Dos monedas	COP y USD sin perder precisión: cada monto se guarda en su moneda original y solo se convierte para mostrarlo.
Deudas	Interés nominal o efectivo anual, y un simulador de pago por avalancha o bola de nieve.
Ahorros	Metas con aportes y estado claro: en camino, atrasada o casi lista.
Suscripciones y calendario	Pagos recurrentes con vencimientos. Nada se da por pagado hasta que tú lo confirmas.
Presupuestos	Límites por categoría y mes, con aviso al acercarte al tope.
Panel	Balance del mes, categorías, tendencia de 6 meses y próximos pagos de un vistazo.
PWA	Se instala en el celular y funciona con barra inferior y bottom sheets en móvil.
Respaldo	Exporta todos tus datos en CSV desde Ajustes.

Principios de diseño

• Claridad antes que adorno. Sin brillos decorativos ni animaciones gratuitas.
• Accesible. Contraste verificado con tests (WCAG), objetivos táctiles de 44 px y respeto a prefers-reduced-motion.
• Dinero exacto. Montos enteros en unidades menores (bigint), nunca decimales flotantes.
• Tus datos, tu hogar. Cada fila está protegida con Row Level Security en la base de datos.

Stack

• Framework: Next.js (App Router) con TypeScript estricto
• Interfaz: Tailwind CSS, shadcn/ui y motion
• Datos y auth: Supabase (Auth + Postgres con RLS)
• Idiomas: next-intl, español (por defecto) e inglés
• Despliegue: Vercel, con tareas programadas para tasas, borrado definitivo y vencimientos
• Pruebas: Vitest y pruebas SQL contra Postgres para RLS y reglas de dinero

Empezar en local

Necesitas Node.js 20+, pnpm y un proyecto de Supabase.

git clone https://github.com/halconrandom/ember-cash.git
cd ember-cash
pnpm install
cp .env.example .env.local   # completa tus valores
pnpm dev

Abre http://localhost:3000.

Variables de entorno

Variable	Dónde se usa	Notas
NEXT_PUBLIC_SUPABASE_URL	cliente y servidor	URL de tu proyecto de Supabase
NEXT_PUBLIC_SUPABASE_ANON_KEY	cliente y servidor	Clave pública (anon)
NEXT_PUBLIC_CONTACT_EMAIL	cliente y servidor	Correo público del aviso, los términos y /.well-known/security.txt. Si falta o no es un correo, la app no arranca
SUPABASE_SERVICE_ROLE_KEY	solo servidor	Nunca con prefijo NEXT_PUBLIC_ ni en el cliente
CRON_SECRET	solo servidor	Al menos 32 caracteres. Genera uno con openssl rand -hex 32
TEST_DATABASE_URL	solo los tests de base de datos	Postgres local (localhost), base que termine en _test. Ver Pruebas de base de datos

La app valida estas variables al arrancar y te dice cuáles faltan.

以上为 README 的开头部分。其余内容请阅读原文。 查看完整 README ↗