{"id":28142185,"url":"https://github.com/manuel-dev-ing/administradorcontactos-full-stack-frontend","last_synced_at":"2025-07-19T22:35:29.278Z","repository":{"id":292616362,"uuid":"981426122","full_name":"Manuel-dev-ing/AdministradorContactos-Full-Stack-FrontEnd","owner":"Manuel-dev-ing","description":null,"archived":false,"fork":false,"pushed_at":"2025-05-25T02:31:38.000Z","size":37,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-05-25T03:28:46.517Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Manuel-dev-ing.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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,"zenodo":null}},"created_at":"2025-05-11T04:34:10.000Z","updated_at":"2025-05-25T02:31:41.000Z","dependencies_parsed_at":"2025-05-11T05:35:01.974Z","dependency_job_id":null,"html_url":"https://github.com/Manuel-dev-ing/AdministradorContactos-Full-Stack-FrontEnd","commit_stats":null,"previous_names":["manuel-dev-ing/administradorcontactos-full-stack-frontend"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Manuel-dev-ing/AdministradorContactos-Full-Stack-FrontEnd","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Manuel-dev-ing%2FAdministradorContactos-Full-Stack-FrontEnd","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Manuel-dev-ing%2FAdministradorContactos-Full-Stack-FrontEnd/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Manuel-dev-ing%2FAdministradorContactos-Full-Stack-FrontEnd/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Manuel-dev-ing%2FAdministradorContactos-Full-Stack-FrontEnd/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Manuel-dev-ing","download_url":"https://codeload.github.com/Manuel-dev-ing/AdministradorContactos-Full-Stack-FrontEnd/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Manuel-dev-ing%2FAdministradorContactos-Full-Stack-FrontEnd/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":266032536,"owners_count":23866960,"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":[],"created_at":"2025-05-14T19:17:55.972Z","updated_at":"2025-07-19T22:35:29.272Z","avatar_url":"https://github.com/Manuel-dev-ing.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 📇 Administrador de Contactos – Frontend\n\nEste proyecto representa el **frontend** de una aplicación web full stack para la gestión de contactos. Permite al usuario **crear, editar, eliminar, listar y agrupar contactos**, así como **visualizar los contactos asociados a cada grupo**. La interfaz es moderna, responsiva y construida con tecnologías actuales del ecosistema React.\n\nEl frontend está desarrollado con:\n\n- **React** y **TypeScript** – Para construir interfaces de usuario robustas y tipadas.\n- **Vite** – Herramienta de desarrollo rápida y ligera.\n- **Zustand** – Manejo de estado global simple y eficiente.\n- **Zod** – Validación de formularios y estructuras de datos.\n- **CSS** y **HTML** – Para el diseño visual y estructura del contenido.\n\nEste frontend se comunica con una **API REST desarrollada en ASP.NET Core** que actúa como backend del sistema.\n\n\u003e ⚠️ Este repositorio incluye únicamente la parte de cliente. La lógica del servidor y la persistencia de datos están en un repositorio backend separado.\n\n## ⚙️ Funcionalidades\n\n- 📋 **Listado de contactos**\n- ➕ **Creación de nuevos contactos**\n- ✏️ **Edición de contactos existentes**\n- ❌ **Eliminación de contactos**\n- 🧑‍🤝‍🧑 **Agrupación de contactos por grupo**.\n- 👁️ **Visualización de contactos por grupo específico**.\n- ⚡ **Interacción en tiempo real** con la API REST (creación, actualización y borrado sin recarga de página).\n- ✅ **Validación de datos** con **Zod** para asegurar integridad en los formularios.\n- 💾 **Manejo de estado global** con **Zustand**\n\n## 🛠️ Tecnologías Usadas\n\n### 🧑‍💻 Core\n- **[React](https://reactjs.org/)**\n- **[TypeScript](https://www.typescriptlang.org/)**\n- **[Vite](https://vitejs.dev/)**\n\n### ⚙️ Estado y Validación\n- **[Zustand](https://zustand-demo.pmnd.rs/)**\n- **[Zod](https://zod.dev/)**\n\n### 🎨 Estilos y UI\n- **CSS**\n- **HTML5**\n\n### 🌐 Comunicación\n- **Fetch API** – Para consumir la API REST desarrollada en ASP.NET Core.\n\n## 🚀 Instalación y Ejecución Local\nSigue estos pasos para clonar, instalar y ejecutar el frontend de la aplicación en tu entorno local:\n\n### 1. Clona el repositorio\n```\ngit clone https://github.com/Manuel-dev-ing/AdministradorContactos-Full-Stack-FrontEnd.git\n\n```\n### 2. Instala las dependencias\nAsegúrate de tener Node.js (v16 o superior recomendado) y npm o yarn instalados\nCon npm:\n```\n  npm install \n```\nCon Yarn:\n```\n  yarn install\n```\n### 3. Ejecuta la aplicación en modo desarrollo\nCon npm:\n```\n  npm run dev\n```\nCon Yarn: \n```\n  yarn dev\n\n```\nEsto iniciará el servidor de desarrollo. Abre tu navegador y visita:\n\n```\n  http://localhost:5173\n\n```\n\n## Licencia\n\nAdministrador de Contactos es [MIT licensed](./LICENSE).\n\n## Contacto\n**Nombre:** Manuel Tamayo Montero.\n\n**Correo:** manueltamayo9765@gmail.com\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmanuel-dev-ing%2Fadministradorcontactos-full-stack-frontend","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmanuel-dev-ing%2Fadministradorcontactos-full-stack-frontend","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmanuel-dev-ing%2Fadministradorcontactos-full-stack-frontend/lists"}