PayTrack es una aplicación diseñada para gestionar deudas de manera eficiente. Permite agregar, visualizar y administrar deudas, así como adjuntar comprobantes en formato de imagen. La aplicación está desarrollada utilizando React, Firebase y otras tecnologías modernas para ofrecer una experiencia de usuario fluida y responsive.
A continuación, se presenta una lista de las tecnologías utilizadas en este proyecto:
- dotenv: ^16.4.5
- firebase: ^10.12.3
- prop-types: ^15.8.1
- react: ^18.3.1
- react-dom: ^18.3.1
- react-hot-toast: ^2.4.1
- react-router: ^6.24.1
- react-router-dom: ^6.24.1
- @types/react: ^18.3.3
- @types/react-dom: ^18.3.0
- @vitejs/plugin-react-swc: ^3.5.0
- autoprefixer: ^10.4.19
- eslint: ^8.57.0
- eslint-plugin-react: ^7.34.2
- eslint-plugin-react-hooks: ^4.6.2
- eslint-plugin-react-refresh: ^0.4.7
- postcss: ^8.4.39
- tailwindcss: ^3.4.4
- vite: ^5.3.1
Para instalar y ejecutar esta aplicación localmente, sigue estos pasos:
-
Clona el repositorio: $ git clone https://github.com/Isaac-Abarca/PayTrack.git $ cd ../path/to/the/file
-
Instala las dependencias: $ npm install
-
Inicia la aplicación: $ npm run dev
Aquí tienes una breve guía de uso de la aplicación:
- Navega a la sección "Agregar Nueva Deuda".
- Rellena los campos requeridos: Deudor, Acreedor, Monto Inicial y Descripción.
- Adjunta un comprobante si es necesario (solo se permiten imágenes).
- Haz clic en "Agregar Deuda". Si todos los campos son válidos, la deuda se agregará a la base de datos de Firebase y podrás verla en la lista de deudas.
- Navega a la sección "Lista de Deudas".
- Aquí verás todas las deudas agregadas, con opciones para ver detalles y eliminar deudas.
Si deseas colaborar en este proyecto, sigue estos pasos:
- Haz un fork del repositorio.
- Crea una nueva rama (
git checkout -b feature/nueva-funcionalidad). - Realiza los cambios necesarios y commitea (
git commit -m 'Agregar nueva funcionalidad'). - Sube tus cambios a tu fork (
git push origin feature/nueva-funcionalidad). - Abre un Pull Request describiendo los cambios realizados.
“La colaboración es la clave del éxito en el desarrollo de software.”
A continuación, algunas preguntas frecuentes:
-
¿Qué hacer si encuentro un bug? Si encuentras un bug, por favor abre un issue detallando los pasos para reproducirlo.
-
¿Cómo puedo solicitar una nueva funcionalidad? Puedes solicitar nuevas funcionalidades abriendo un issue y etiquetándolo como "enhancement".
-
¿Es posible usar esta aplicación en dispositivos móviles? Sí, la aplicación está diseñada para ser responsive y funcionar en dispositivos móviles.
-
¿Qué bases de datos soporta la aplicación? Actualmente, la aplicación utiliza Firebase Firestore como base de datos.
Este proyecto está bajo la licencia MIT. Consulta el archivo LICENSE para obtener más detalles.