https://github.com/vgnshiyer/simple-diet-planner
Simple diet planner
https://github.com/vgnshiyer/simple-diet-planner
diet fitness meal-planner nutrition tracker tracking
Last synced: 5 months ago
JSON representation
Simple diet planner
- Host: GitHub
- URL: https://github.com/vgnshiyer/simple-diet-planner
- Owner: vgnshiyer
- License: mit
- Created: 2025-03-15T17:26:35.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2025-03-25T14:37:36.000Z (7 months ago)
- Last Synced: 2025-05-07T10:19:11.576Z (5 months ago)
- Topics: diet, fitness, meal-planner, nutrition, tracker, tracking
- Language: TypeScript
- Homepage: http://blog.vgnshiyer.dev/simple-diet-planner/
- Size: 1.39 MB
- Stars: 0
- Watchers: 1
- Forks: 1
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Simple Diet Planner
A simple way to plan and track your diet on your web browser.
[](https://github.com/vgnshiyer/simple-diet-planner/blob/master/LICENSE)
[](https://www.linkedin.com/comm/mynetwork/discovery-see-all?usecase=PEOPLE_FOLLOWS&followMember=vgnshiyer)
[](https://www.buymeacoffee.com/vgnshiyer)
## Features
- **Track meals:** Tweak your macros and foods according to your goals.
- **Search for foods:** Easily search for foods and add them to your plan with a database of over 1 million foods from the Nutritionix API.
- **Summarize your daily intake:** See a detailed summary of your macros and calories.
- **User friendly interface:** Add meals and ingredients with a click of a button.
## Getting started
1. Get a free API key from [Nutritionix](https://developer.nutritionix.com/signup) and enter it in the App setup. (You only have to do this once.)
2. Add your meals to your plan. It will automatically save it to your browser's local storage.
3. Search for foods, select the quantity and add them to a meal.
4. A summary of your daily intake will be displayed on the right side of the screen.
5. Tweak your macros and foods according to your goals.
## Development
### Local Setup
```bash
npm install
```
### Running the application
```bash
npm run dev
```
### Building the application
```bash
npm run build
```
## Contributing
Thank you for your interest in contributing to this project!
To contribute, please fork the repository and create a pull request.
### Opening Issues
If you encounter a bug, have a feature request, or want to discuss something related to the project, please open an issue on the GitHub repository. When opening an issue, please provide:
**Bug Reports**: Describe the issue in detail. Include steps to reproduce the bug if possible, along with any error messages or screenshots.
**Feature Requests**: Clearly explain the new feature you'd like to see added to the project. Provide context on why this feature would be beneficial.
**General Discussions**: Feel free to start discussions on broader topics related to the project.
## License
This project is licensed under the MIT License. See the [LICENSE](https://github.com/vgnshiyer/simple-diet-planner/blob/master/LICENSE) file for details.