{"id":26533626,"url":"https://github.com/jimcostdev/finances-ui","last_synced_at":"2026-04-13T04:49:19.827Z","repository":{"id":283688473,"uuid":"952188151","full_name":"JimcostDev/finances-ui","owner":"JimcostDev","description":"MyFinances es un proyecto para la gestión de finanzas personales. Esta es la parte frontend de finances-api.","archived":false,"fork":false,"pushed_at":"2025-03-21T15:02:45.000Z","size":90,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-03-21T16:22:20.610Z","etag":null,"topics":["astro","react","tailwindcss"],"latest_commit_sha":null,"homepage":"https://jimcostdev.com","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/JimcostDev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-03-20T21:54:05.000Z","updated_at":"2025-03-21T15:02:49.000Z","dependencies_parsed_at":"2025-03-21T16:36:10.208Z","dependency_job_id":null,"html_url":"https://github.com/JimcostDev/finances-ui","commit_stats":null,"previous_names":["jimcostdev/finances-ui"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JimcostDev%2Ffinances-ui","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JimcostDev%2Ffinances-ui/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JimcostDev%2Ffinances-ui/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JimcostDev%2Ffinances-ui/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/JimcostDev","download_url":"https://codeload.github.com/JimcostDev/finances-ui/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244852683,"owners_count":20521160,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["astro","react","tailwindcss"],"created_at":"2025-03-21T19:19:04.137Z","updated_at":"2026-04-13T04:49:19.818Z","avatar_url":"https://github.com/JimcostDev.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# finances-ui (MyFinances)\n\nFrontend web para gestionar finanzas personales: reportes mensuales y anuales, balance general, categorías de ingresos y gastos, perfil de usuario y autenticación por sesión (cookies HttpOnly).\n\n## Stack\n\n| Tecnología | Uso |\n|------------|-----|\n| [Astro](https://astro.build/) 6 | Páginas `.astro`, modo `server` (SSR) |\n| [React](https://react.dev/) 19 | Formularios y vistas interactivas (islas) |\n| [Tailwind CSS](https://tailwindcss.com/) 4 | Estilos (`@tailwindcss/vite`) |\n| TypeScript 5 | Tipado estricto (`astro/tsconfigs/strict`) |\n| [@astrojs/vercel](https://docs.astro.build/en/guides/integrations-guide/vercel/) | Despliegue en Vercel |\n\nLas peticiones al backend usan `fetch` con `credentials: \"include\"` para enviar la cookie de sesión.\n\n## Requisitos\n\n- Node.js compatible con Astro 6 (recomendado: LTS actual)\n- Backend API disponible (ver configuración de URL abajo)\n\n## Instalación y comandos\n\nDesde la carpeta `finances-ui`:\n\n```bash\nnpm install\nnpm run dev      # http://localhost:4321\nnpm run build    # salida en ./dist/\nnpm run preview  # vista previa del build\n```\n\n## Configuración del API\n\nLa URL base del backend está en `src/config/apiUrl.ts` (`API_BASE_URL`). Para desarrollo local, apunta al servidor que expongas (por ejemplo el puerto de tu API) y ajusta según tu entorno.\n\n## Estructura principal\n\n```text\nsrc/\n├── components/     # React: auth, dashboard, reports, user, layout, icons\n├── config/         # p. ej. apiUrl\n├── interfaces/     # Tipos compartidos (IUser, IReport, …)\n├── layouts/        # Layouts Astro\n├── pages/          # Rutas (login, register, dashboard, reportes, …)\n├── services/       # Llamadas HTTP a /api (auth, reportes, usuario)\n└── utils/          # Utilidades (p. ej. manejo de errores)\n```\n\nAlias TypeScript (ver `tsconfig.json`): `@components/*`, `@layouts/*`, `@services`, `@interfaces`, `@utils/*`, `@styles/*`.\n\n## Rutas de páginas (resumen)\n\n| Ruta | Descripción |\n|------|-------------|\n| `/` | Inicio |\n| `/login`, `/register` | Autenticación |\n| `/dashboard` | Panel con navegación a reportes, crear reporte, anual, balance, perfil |\n| `/reports`, `/create-report`, `/annual-report`, `/general-balance` | Vistas de reportes |\n| `/edit-report/[id]`, `/delete-report/[id]` | Edición y borrado |\n| `/edit-profile`, `/delete-user` | Perfil y baja de cuenta |\n\n## Desarrollo\n\n- Los componentes React viven bajo `src/components/` y se importan en las páginas `.astro` con `client:load` u otras directivas según necesidad.\n- Para comprobar tipos: `npx astro check` (si está disponible en tu entorno) o el análisis del IDE con la configuración del proyecto.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjimcostdev%2Ffinances-ui","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjimcostdev%2Ffinances-ui","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjimcostdev%2Ffinances-ui/lists"}