Skip to content

Repository files navigation

SaborSpin Logo

SaborSpin

Shake up your plate - Variety-enforced meal suggestions

License: MIT PRs Welcome


What is SaborSpin?

SaborSpin helps you decide what to eat without repeating meals too often. Get personalized meal suggestions based on your ingredients and eating history.

Problem: Decision fatigue around daily meals. Eating the same things repeatedly.

Solution: Variety-enforced meal suggestions that prevent repetition while respecting your preferences.

Website: saborspin.com


Features

  • Variety Enforced - Algorithm prevents repeating ingredients within your cooldown period
  • Fast Decisions - Pick a meal in under 20 seconds
  • Fully Customizable - Add your own ingredients, categories, and meal types
  • Meal Tracking - See your eating history and patterns
  • Dark Mode - Easy on the eyes, day or night
  • Privacy First - All data stored locally, no cloud sync
  • Cross-Platform - iOS, Android, and Web

Screenshots

Suggestions Screen

Download

Android

  • Download APK from Releases
  • Coming soon to Google Play Store

iOS

Coming soon to the App Store

Web

Try the web version (data not persisted) by running locally.


Quick Start for Developers

# Clone the repo
git clone https://github.com/vitorsilva/saborspin.git
cd saborspin/demo-react-native-app

# Install dependencies
npm install

# Start development server
npm start

# Run tests
npm test

# Run E2E tests
npm run test:e2e

See Installation Guide for detailed setup.


Built With

Technology Purpose
React Native + Expo Mobile framework
SQLite Local-first database
Zustand State management
TypeScript Type safety
Playwright E2E testing

Documentation

Document Description
User Guide How to use SaborSpin
Architecture Technical documentation
Developer Guide Setup and development
Contributing How to contribute
Changelog Version history

Project Status

Epic Status
Epic 1: Infrastructure & Foundation Complete
Epic 2: Meals Randomizer Features Complete
Epic 3: Production Readiness Complete

Test Coverage: 101+ unit tests, 12 E2E tests


Contributing

Contributions are welcome! Please read our Contributing Guide and Code of Conduct.


Brand

  • Name: SaborSpin (sabor = flavor in Portuguese)
  • Tagline: "Shake up your plate"
  • Colors: Orange #FF6B35 | Green #4CAF50 | Yellow #FFC107

License

This project is licensed under the MIT License - see the LICENSE file.


Made with care in Portugal

About

small react native app to learn the fundamentals

Resources

Code of conduct

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages