Esta es mi participación en el hackathon JOBarcelona 2023. Beecipes es una app de recetas que usa la API de Spoonacular para obtener recetas y mostrarlas de forma amigable. Se completó en menos de 24 horas como reto.
-
Esta app está construida con React y Recoil.
-
Usa la API de Spoonacular para obtener y mostrar recetas.
Funcionalidades
- Buscar recetas por nombre
- Buscar recetas de forma aleatoria
- Almacenamiento local para guardar recetas
- Menos llamadas a la API para ahorrar datos
Estas funcionalidades están diseñadas para mejorar la experiencia del usuario proporcionando utilidades prácticas y reduciendo la cantidad de datos que se deben obtener de la API. La búsqueda por nombre permite encontrar rápidamente la receta deseada, mientras que la búsqueda aleatoria ofrece una forma divertida y sencilla de descubrir recetas nuevas.
El uso del almacenamiento local mejora la experiencia al permitir guardar recetas favoritas y acceder a ellas sin conexión, reduciendo la dependencia de la conectividad a internet.
Finalmente, al reducir el número de llamadas a la API, se ahorra en uso de datos y se mejora la velocidad general de la aplicación — una consideración importante para usuarios con planes de datos limitados o conexiones más lentas.
Instalación
Este proyecto está construido con Vite.
-
Clona el repositorio
git clone https://github.com/PolGubau/hackathon-JOBarcelona-recipes-2023.git -
Instala las dependencias
pnpm i -
Ejecuta el proyecto
pnpm run dev -
Abre el proyecto en tu editor de código preferido.
Uso
Para usar la app necesitas obtener una API key de Spoonacular.
Tras obtener la API key, sigue estos pasos:
- Abre el proyecto en tu editor de código preferido.
- Navega al archivo
src/models/url.tsy reemplazaYOUR_API_KEYcon tu API key real. - Guarda los cambios.
- Abre el proyecto con
npm run dev.
Ya puedes usar la app para buscar recetas por nombre o de forma aleatoria, y guardarlas en el almacenamiento local.
Nota: Asegúrate de tener una conexión estable a internet mientras usas la app para evitar errores al obtener datos de la API.
Hoja de Ruta
- Filtrar recetas por ingredientes, calorías, etc.
- Añadir una lista de la compra
- Añadir una lista de favoritos
- Añadir un sistema de login
Contribuciones
- Haz fork del proyecto en Github
- Crea una nueva rama
- Haz commit de tus cambios
- Sube los cambios a la rama
- Abre un pull request
Licencia
Este proyecto está licenciado bajo la Licencia MIT. Es totalmente libre de usar y modificar al ser Open Source.
Enlaces
