🐂 Red Bull Intake Tracker

Track your Red Bull consumption with per-can logging, barcode scanning, spending insights, and a coach. Built with React, Appwrite, and Material You theming.

Features

Quick logging — tap a flavour, pick a size, done. Cans are tracked with timestamp, price, and store
Barcode scanning — scan any Red Bull can (EAN-13/EAN-8/UPC-A) and it auto-fills flavour, size, and caffeine. 475+ verified barcodes built in, with user overrides
20 built-in flavours — Original, Zero, Ruby, Tropical, Dragon Fruit, and more, each with its own accent colour
Daily limits — set max cans/day, max spend/day, and a cut-off time. Get warned when you're about to breach
Charts & analytics — intake over time, flavour breakdown (pie chart), spending trends, caffeine metrics
Import — bulk import from Excel (.xlsx) or JSON, with duplicate detection and row-level error preview
Export — download your data as Excel or JSON anytime
Material You theming — every flavour gets its own dynamic colour palette. Dark mode included
Onboarding flow — guided setup for new users with limit preferences
Appwrite auth — email/password login, row-level security per user

Tech Stack

Layer	Tech
Frontend	React 18, TypeScript, Vite
Styling	Tailwind CSS, Framer Motion
Charts	Recharts
Backend	Appwrite Cloud (auth, database, storage)
Barcode	@zxing/browser
Import/Export	ExcelJS

Getting Started

Prerequisites

Node.js 18+
An Appwrite Cloud project (free tier works)

Setup

Clone and install:

git clone https://github.com/nh9961/Red-Bull-Tracker.git
cd Red-Bull-Tracker
npm install

Copy the environment template:

cp .env.example .env.local

Fill in your Appwrite credentials in .env.local (see Appwrite Setup for full instructions)
Create the database and collections:

APPWRITE_API_KEY=your-admin-key npm run setup:appwrite

Start the dev server:

npm run dev

The app runs at http://localhost:5173.

Environment Variables

Variable	Required	Description
`VITE_APPWRITE_ENDPOINT`	Yes	Appwrite endpoint (e.g. `https://fra.cloud.appwrite.io/v1`)
`VITE_APPWRITE_PROJECT_ID`	Yes	Your Appwrite project ID
`VITE_APPWRITE_DATABASE_ID`	Yes	Database ID (default: `redbull_tracker`)
`VITE_APPWRITE_COLLECTION_ID`	Yes	Intake entries collection ID
`VITE_OLLAMA_PROXY_URL`	No	Proxy endpoint
`OLLAMA_API_KEY`	No	Server-side API key
`OLLAMA_MODEL`	No	Model for coach
`APPWRITE_API_KEY`	No	Admin key for `setup:appwrite` script only

Project Structure

src/
├── App.tsx                    # Main app shell, routing, layout
├── components/
│   ├── BarcodeScannerModal.tsx  # Camera barcode scanner
│   ├── BarcodeProductPreview.tsx
│   ├── CoachPanel.tsx           # Coach chat UI
│   ├── DailyLimitsCard.tsx      # Limit status & warnings
│   ├── LimitsSettingsForm.tsx
│   └── OnboardingScreen.tsx
├── data/
│   ├── flavours.ts             # 20 built-in flavour definitions
│   ├── themes.ts               # Material You theme tokens per flavour
│   ├── barcodes.ts
│   └── verified-barcodes.json  # 475+ verified product barcodes
├── lib/
│   ├── appwrite.ts             # Appwrite client init
│   ├── appwriteEntries.ts      # CRUD for intake entries
│   ├── appwriteBarcodes.ts     # Barcode product storage
│   ├── barcodeLookup.ts        # Multi-source barcode resolution
│   ├── barcodeScanner.ts       # @zxing scanner wrapper
│   ├── userBarcodeMappings.ts  # Per-user barcode overrides
│   ├── coachChats.ts           # Chat persistence
│   ├── useCoachSession.ts      # Chat hook
│   ├── userLimits.ts           # Daily limit logic
│   ├── metrics.ts              # Computed stats & charts
│   ├── excel.ts                # Excel import/export
│   ├── storage.ts              # Local storage helpers
│   ├── themeTokens.ts          # Dynamic theme generation
│   └── greeting.ts
└── types.ts                    # All TypeScript types

Scripts

Command	Description
`npm run dev`	Start Vite dev server
`npm run build`	Type-check and build for production
`npm run preview`	Preview production build
`npm run lint`	ESLint check
`npm run setup:appwrite`	Create/update Appwrite database resources

License

MIT

Built by Ned Halksworth

5.0 KiB Raw Blame History