https://github.com/proximobinks/free2eat
An allergy-friendly recipe finder web app developed for a Year 12 SACE project. Free2Eat helps users discover recipes that match their dietary restrictions with a mobile-friendly interface and persistent preferences.
https://github.com/proximobinks/free2eat
allergy-friendly dietary-restrictions food-app mobile-friendly netlify nextjs react recipe-app sace-project tailwindcss
Last synced: 8 months ago
JSON representation
An allergy-friendly recipe finder web app developed for a Year 12 SACE project. Free2Eat helps users discover recipes that match their dietary restrictions with a mobile-friendly interface and persistent preferences.
- Host: GitHub
- URL: https://github.com/proximobinks/free2eat
- Owner: ProximoBinks
- Created: 2024-05-11T12:31:26.000Z (about 2 years ago)
- Default Branch: rev1
- Last Pushed: 2025-05-21T11:03:54.000Z (about 1 year ago)
- Last Synced: 2025-05-21T11:51:13.352Z (about 1 year ago)
- Topics: allergy-friendly, dietary-restrictions, food-app, mobile-friendly, netlify, nextjs, react, recipe-app, sace-project, tailwindcss
- Language: JavaScript
- Homepage: https://free2eat.netlify.app/
- Size: 2.08 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Free2Eat
A web application for finding allergy-friendly recipes that cater to specific dietary needs without compromising on taste.
**Live Demo:** [https://free2eat.netlify.app/](https://free2eat.netlify.app/)
## About
Free2Eat was developed as a Year 12 SACE Assessment Item Folio (AIF) project. The application helps users discover recipes that match their dietary restrictions, including options for dairy-free, gluten-free, nut-free, egg-free, sesame-free, and vegan diets.
## Features
- **Allergy Filtering**: Select multiple dietary restrictions to find suitable recipes
- **Recipe Search**: Search for recipes by name, description, or ingredients
- **Mobile-Friendly Design**: Responsive interface optimized for all device sizes
- **Recipe Details**: View ingredients, instructions, and images for each recipe
- **Persistent Preferences**: User dietary preferences are saved between sessions
## Technologies Used
- **Next.js**: React framework for server-rendered applications
- **TailwindCSS**: Utility-first CSS framework for styling
- **LocalStorage**: Browser storage for saving user preferences
- **Static Data**: JSON-based recipe database
## Getting Started
### Prerequisites
- Node.js (version 14 or higher)
- npm or yarn
### Installation
1. Clone the repository
```bash
git clone https://github.com/yourusername/free2eat.git
cd free2eat
```
2. Install dependencies
```bash
npm install
# or
yarn install
```
3. Run the development server
```bash
npm run dev
# or
yarn dev
```
4. Open [http://localhost:3000](http://localhost:3000) in your browser
## Deployment
This project is configured for deployment on Netlify:
```bash
npm run build
npm run export
```
The static export will be in the `out` directory, ready for deployment.
## Project Structure
- `pages/`: Application routes and pages
- `components/`: Reusable UI components
- `data/`: Recipe JSON data
- `public/`: Static assets like images
- `styles/`: Global CSS styles
## Screenshots
*Home page with allergy filter options*
## License
This project was created for educational purposes as part of a SACE Assessment Item Folio.
## Acknowledgments
- Special thanks to all who contributed to the development and testing of this application
- Recipe images and data are for demonstration purposes only