Skip to content
LogisitePublic

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

2 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 

Repository files navigation

Team-B

NutriLocal

AI-powered local meal intelligence for Africa.

Built during The Build — NSK AI / Udara Project 2026


The Crew

Member Country Role
[CREW MEMBER 1 — Name] [Country] [Role]
[CREW MEMBER 2 — Name] [Country] [Role]
[CREW MEMBER 3 — Name] [Country] [Role]

GitHub: https://github.com/Logisite/Team-B


Week 1 Submission Documents

Document Link
Who Hurts Most docs/who_hurts_most.md
Validation Conversations docs/validation_conversations.md
Architecture Diagram docs/architecture_diagram.md
Tech Stack Writeup docs/tech_stack.md

1. WHO HURTS MOST — ONE PAGER

The User

The people who hurt most are everyday Africans — starting with Nigerians — who are trying to eat better but are forced to make food decisions under real constraints.

They are:

  • Students living on limited weekly budgets
  • Young professionals balancing health and cost
  • Parents feeding families under rising food prices
  • Gym-goers trying to hit nutrition goals cheaply
  • People with dietary goals but little nutrition guidance
  • Low-income households trying to avoid unhealthy eating patterns

These users are not asking for perfect diets. They are asking:

  • "What is the best meal I can make with what I have?"
  • "What can I eat today that is healthier but still affordable?"
  • "Which local food gives me the nutrients I need?"
  • "What alternatives can I use if I cannot afford this ingredient?"
  • "How do I eat better without eating foreign foods?"

Where They Are

Our initial market is Nigeria.

The first users are:

  • University students
  • Early-career workers
  • Urban and semi-urban households
  • Health-conscious young adults

Many existing nutrition apps are built around Western diets and ingredients. They suggest foods that are unavailable, culturally unfamiliar, or unrealistic for local users.

Examples:

  • Zucchini
  • Avocado-heavy diets
  • Imported protein plans
  • Expensive supplements

This creates a gap between nutrition advice and practical reality.


What Hurts

The pain is not just hunger.

The real pain is uncertainty.

Users struggle daily with:

  • Not knowing what balanced meal to prepare
  • Choosing meals under tight budgets
  • Limited understanding of nutrients in local foods
  • Lack of affordable healthy options
  • Poor diet planning knowledge
  • Conflicting health advice online
  • Wasting money on inefficient food choices

Even users who want to eat healthier often fail because existing tools:

  • Ignore local food culture
  • Ignore local availability
  • Ignore price sensitivity
  • Ignore regional recipes
  • Assume ideal conditions instead of reality

The result is unhealthy eating patterns, poor nutrition decisions, avoidable deficiencies, and frustration.


The Opportunity

NutriLocal helps users make smarter food decisions using:

  • Local ingredients
  • Local recipes
  • Budget constraints
  • Nutrition goals
  • Ingredient availability
  • Dietary preferences

The system recommends practical meals that users can actually make.

Instead of: "Eat salmon and quinoa."

NutriLocal says: "Here are 3 affordable balanced meals you can make this week in Lagos under ₦4,000 using foods available near you."


Why Now

Three trends make this the right time:

  1. Rising food costs across Africa
  2. Growing health awareness among young Africans
  3. AI systems becoming capable of contextual recommendation and reasoning

The internet already contains nutrition knowledge. The missing layer is local intelligence.

That is the problem NutriLocal solves.


2. VALIDATION CONVERSATIONS

Validation Goal

Our goal was to validate:

  1. Whether users struggle with food decision-making
  2. Whether budget-aware nutrition is a real pain point
  3. Whether users trust local-first recommendations more than generic diet apps
  4. Whether ingredient-aware recommendations are valuable
  5. Whether users would repeatedly use such a system

Conversation 1

User

University student, Lagos, Nigeria

Summary

The user explained that food budgeting is a weekly struggle and that most healthy food advice online feels unrealistic.

Verbatim Feedback

"I know noodles every day is not healthy, but most apps recommend foods I cannot afford or even find nearby."

Insight

Users want practical meal alternatives within budget constraints.


Conversation 2

User

Young professional, Abuja, Nigeria

Summary

The user wanted healthier eating options but struggled to plan meals around work schedules and available ingredients.

Verbatim Feedback

"If an app could tell me what healthy meal I can make quickly using foods I already have, I would use it daily."

Insight

Convenience + local availability is highly valuable.


Conversation 3

User

Gym-goer, Port Harcourt, Nigeria

Summary

The user tracks protein intake manually and substitutes ingredients frequently due to pricing.

Verbatim Feedback

"I spend too much time searching for cheap protein alternatives."

Insight

Goal-based nutrition recommendations are valuable.


Conversation 4

User

Parent, Ibadan, Nigeria

Summary

The user wanted balanced meals for children but lacked confidence in understanding nutrition.

Verbatim Feedback

"I just want to know if what my children are eating is actually balanced."

Insight

Nutrition explanation and confidence-building matter.


Conversation 5

User

NYSC member, Enugu, Nigeria

Summary

The user often cooks based on whatever ingredients are cheapest nearby.

Verbatim Feedback

"I don't need fancy food. I need to know the smartest meal for my money."

Insight

Users optimise for value, not perfection.


Questions Used During Validation

  1. Tell me about the last time you had to decide what to eat with limited money or ingredients.
  2. What matters most when choosing food: price, taste, fullness, health, or speed?
  3. Have you ever wanted healthier meals but could not figure out what to cook?
  4. What makes nutrition apps unrealistic for you?
  5. If a system recommended meals based on your budget and nearby foods, would you trust it?
  6. What would make you stop using it?

3. ARCHITECTURE DIAGRAM

High-Level System Architecture

flowchart TD
    A[User] --> B[Next.js Web App]
    B --> C[Authentication Layer]
    B --> D[Meal Recommendation Engine]

    D --> E[Recipe Database]
    D --> F[Nutrition Knowledge Base]
    D --> G[Local Ingredient & Price Layer]
    D --> H[AI Reasoning Layer]

    H --> I[Gemini API\nGoogle AI Studio Free Tier]

    D --> J[Recommendation Results]

    J --> K[Meal Plans]
    J --> L[Nutrient Breakdown]
    J --> M[Ingredient Alternatives]
    J --> N[Budget Analysis]

    B --> O[Analytics]
    B --> P[Error Monitoring]
Loading

User Flow Diagram

sequenceDiagram
    participant U as User
    participant W as Web App
    participant A as Auth Service
    participant R as Recommendation Engine
    participant DB as Database
    participant AI as Gemini API

    U->>W: Enter budget, goals, ingredients, location
    W->>A: Authenticate user
    A-->>W: Session token

    W->>R: Send user constraints
    R->>DB: Fetch recipes and nutrition data
    R->>AI: Generate optimized recommendations

    AI-->>R: Ranked meal suggestions
    R-->>W: Return recommendations

    W-->>U: Show meals, nutrients, prices, alternatives
Loading

Infrastructure Overview

Component Technology
Frontend Next.js
Hosting Vercel
Backend Supabase + Edge Functions
Database PostgreSQL
Authentication Supabase Auth
AI Layer Gemini API (Google AI Studio)
Analytics PostHog
Monitoring Sentry
CDN / Security Cloudflare
Repository GitHub
CI/CD GitHub Actions

Authentication Design

Authentication is handled using Supabase Auth.

Supported methods:

  • Email/password
  • Google sign-in (future)

Authentication is necessary for:

  • Saving meal preferences
  • Storing user goals
  • Tracking recommendation history
  • Personalising recommendations over time

Data Flow

Inputs

  • Budget
  • Ingredients available
  • Dietary preferences
  • Nutrition goals
  • User location

Processing

  • Recipe matching
  • Ingredient substitution
  • Nutrition scoring
  • Price optimisation
  • AI-assisted ranking

Outputs

  • Meal recommendations
  • Nutritional explanation
  • Cost estimation
  • Ingredient alternatives
  • Meal preparation suggestions

4. TECH STACK WRITEUP

Frontend — Next.js

We chose Next.js because:

  • Fast development speed
  • Excellent React ecosystem
  • Easy deployment
  • Server-side rendering support
  • Strong developer experience
  • Good performance for mobile-first applications

Free Tier

Vercel Hobby Plan

Why:

  • Free deployments
  • Preview deployments
  • CI/CD integration
  • Edge delivery
  • Good support for student/startup projects

Backend — Supabase

We chose Supabase because:

  • PostgreSQL database included
  • Built-in authentication
  • Realtime support
  • Edge functions
  • Fast backend setup
  • Easy integration with Next.js

Free Tier

Supabase Free Plan

Why:

  • Free PostgreSQL database
  • Free authentication
  • Free storage
  • Suitable for MVP-stage products

Database — PostgreSQL

We chose PostgreSQL because:

  • Structured relational data fits recipes and nutrition well
  • Strong querying capabilities
  • Reliable and scalable
  • Excellent ecosystem support

The database stores:

  • Recipes
  • Ingredients
  • Nutrition values
  • User preferences
  • Budget history
  • Regional food mappings

AI Layer — Gemini API (Google AI Studio)

We chose Gemini because:

  • Google AI Studio provides a genuinely free tier with no credit card required
  • Gemini 1.5 Flash is fast, cost-efficient, and capable for structured recommendation tasks
  • Strong reasoning for contextual queries in the food and nutrition domain
  • Natural language understanding of local food names and contexts
  • Fully compliant with The Build's free-tiers-only rule

Free Tier

Google AI Studio Free Tier

Limits:

  • 15 requests per minute
  • 1,000,000 tokens per day
  • 1,500 requests per day (Gemini 1.5 Flash)

The AI layer helps with:

  • Meal optimisation
  • Ingredient substitution
  • Natural language food understanding
  • Personalised recommendations

We minimise token costs by:

  • Using retrieval before generation
  • Caching common recommendations
  • Keeping prompts compact

Hosting & Security — Cloudflare

We chose Cloudflare because:

  • Free CDN
  • Free SSL
  • Basic DDoS protection
  • Fast global delivery
  • DNS management

This helps keep the application fast and secure.


Analytics — PostHog

We chose PostHog because:

  • Product analytics
  • Session replay
  • Funnel tracking
  • User behaviour understanding

We will use analytics to:

  • Understand recommendation quality
  • Measure retention
  • Track feature usage
  • Improve meal suggestions

Monitoring — Sentry

We chose Sentry because:

  • Error tracking
  • Performance monitoring
  • Debugging support
  • Production observability

This helps us identify failures quickly.


CI/CD — GitHub Actions

We chose GitHub Actions because:

  • Free for public repositories
  • Integrated into GitHub
  • Easy automated testing
  • Pull request validation

We will use it for:

  • Running tests
  • Linting
  • Deployment workflows

5. INITIAL GITHUB README

NutriLocal

AI-powered local meal intelligence for Africa.

Problem

Millions of Africans struggle daily to make healthy food decisions under real constraints such as:

  • Budget
  • Ingredient availability
  • Limited nutrition knowledge
  • Local food accessibility

Existing nutrition systems are often disconnected from African realities.

Solution

NutriLocal recommends balanced and affordable meals using:

  • Local foods
  • Local recipes
  • User goals
  • Budget constraints
  • Ingredient availability

Core Features

  • Budget-aware meal recommendations
  • Local ingredient understanding
  • Nutrition scoring
  • Ingredient substitution
  • Goal-based suggestions
  • Meal planning

Tech Stack

  • Next.js
  • Supabase
  • PostgreSQL
  • Gemini API (Google AI Studio)
  • Vercel
  • PostHog
  • Sentry

Vision

To become Africa's most intelligent local nutrition and meal recommendation platform.


6. WEEK 1 SUBMISSION CHECKLIST

Completed

  • Problem definition
  • User identification
  • Validation conversations
  • System architecture
  • Tech stack planning
  • Infrastructure planning
  • Public repository initialisation

Next Steps

Week 2 goals:

  • Launch first public MVP
  • Build recommendation flow
  • Deploy live application
  • Configure CI/CD
  • Add initial tests
  • Implement authentication
  • Create first recommendation dataset

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors