Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/anabartos/calculadora-propinas-react-ts
Aplicación de cálculo de propinas y gestión de pedidos desarrollada con React, TypeScript, Vite y Tailwind CSS. Permite agregar elementos al pedido, seleccionar un porcentaje de propina y ver totales de forma rápida y sencilla.
https://github.com/anabartos/calculadora-propinas-react-ts
Last synced: 10 days ago
JSON representation
Aplicación de cálculo de propinas y gestión de pedidos desarrollada con React, TypeScript, Vite y Tailwind CSS. Permite agregar elementos al pedido, seleccionar un porcentaje de propina y ver totales de forma rápida y sencilla.
- Host: GitHub
- URL: https://github.com/anabartos/calculadora-propinas-react-ts
- Owner: anabartos
- Created: 2024-10-31T17:37:53.000Z (about 2 months ago)
- Default Branch: main
- Last Pushed: 2024-11-16T11:32:47.000Z (about 1 month ago)
- Last Synced: 2024-11-16T12:26:27.975Z (about 1 month ago)
- Language: TypeScript
- Size: 37.1 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Calculadora de Propinas
## Descripción
La **Calculadora de Propinas** es una aplicación web desarrollada en React y TypeScript, optimizada con **Vite**. Esta herramienta facilita el cálculo de propinas. Los usuarios pueden agregar elementos al pedido, seleccionar el porcentaje de propina y visualizar el total a pagar.
## Características
- **Selección de Propina**: Elige entre porcentajes predefinidos (10%, 20%, 50%) o ajusta el porcentaje manualmente.
- **Cálculo de Totales**: Muestra el subtotal, el valor de la propina y el total general.
- **Gestión de Pedido**: Agrega o elimina elementos de tu pedido fácilmente.
- **Reinicio de Pedido**: Un botón permite reiniciar el pedido y la selección de propina.
## Instalación:
Sigue estos pasos para ejecutar el proyecto en tu máquina local.
### 1. Clonar el repositorio:
```bash
git clone https://github.com/anabartos/Calculadora-Propinas-React-TS.git
cd Calculadora-Propinas-React-TS
```
### 2. Instalar las dependencias:
```bash
npm install
```
### 3.Ejecutar el servidor de desarrollo:
Para iniciar el proyecto en modo de desarrollo, utiliza el siguiente comando:
```bash
npm run dev
```
## Tecnologías Utilizadas
- **Vite**: Herramienta de desarrollo rápida para proyectos en React y TypeScript.
- **React**: Biblioteca para construir interfaces de usuario.
- **TypeScript**: Mejora la calidad del código mediante tipado estático.
- **Tailwind CSS**: Proporciona estilos rápidos y responsivos.
## Componentes Principales
- **MenuItem**: Representa un elemento del menú, mostrando su nombre y precio, y permite agregarlo al pedido.
- **OrderContents**: Muestra el contenido actual del pedido y permite eliminar elementos.
- **OrderTotals**: Calcula y presenta el subtotal, la propina y el total a pagar.
- **TipPercentageForm**: Facilita la selección del porcentaje de propina a través de opciones de radio.
- **useOrder Hook**: Maneja el estado del pedido, incluyendo agregar, eliminar y restablecer elementos, así como el porcentaje de propina.
## Acceso a la Aplicación
La aplicación está desplegada en Netlify y se puede acceder en el siguiente enlace:
[Calculadora de Propinas en Netlify](https://calculadora-propinas-app.netlify.app)
## Contribuciones
Las contribuciones son bienvenidas. Si deseas mejorar esta aplicación, no dudes en abrir un *issue* o enviar un *pull request*.