Skip to content

Latest commit

 

History

4 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Symply – Personal Symptom & Pattern Tracker

Symply is a clean, calming, privacy‑friendly web app for logging symptoms, spotting patterns, and generating AI‑assisted summaries you can share with a healthcare professional. Built to feel supportive—not clinical.

👉 Live Demo: https://symply-ea2dc.web.app


✨ Core Features

🏠 Home Page

  • Parallax scrolling with calming animations
  • Welcoming design with cool green colors and floating elements
  • Clear call-to-action to start logging symptoms
  • Trust indicators highlighting gentle tracking, clear insights, and better communication

📊 Dashboard

  • Google Authentication - Optional sign-in to save data to the cloud
  • Calendar date picker with today's date as default
  • Comprehensive logging form with:
    • Text area for symptom description ("What happened?")
    • Interactive severity slider (1-10) with emojis and color indicators
    • Trigger dropdown (Food, Sleep, Stress, Exercise, Weather, Medication, Unknown)
  • Symptom entry cards displaying:
    • Visual severity indicators (emoji and color)
    • Date and time stamps
    • Edit and delete functionality
    • Grid layout sorted by date and time
  • Data Storage Options:
    • Logged in: Data saved to Firebase Firestore
    • Not logged in: Data saved locally in browser

📋 AI Report Page

  • Falcon‑7B‑Instruct powered analysis (or smart local fallback)
  • Extracts severity range, trigger distribution, temporal patterns
  • Keyword‑aware recommendations (sleep, stress, caffeine, hydration, medication context)
  • Copy / download export

🔐 Flexible Data Model

  • Optional Google sign‑in (continue fully anonymous if you prefer)
  • Firestore sync when authenticated
  • Local storage fallback (works offline)
  • Graceful degradation: everything still works without cloud

🧪 Architecture Overview

Layer Purpose
React + TypeScript Component structure & type safety
Vite Ultra fast local dev & build
Tailwind CSS Utility-first styling + typography plugin
Framer Motion Micro‑interactions & subtle motion
Firebase Auth Google OAuth (optional)
Firestore Per‑user document + subcollections for logs & summaries
LocalStorage Anonymous / offline persistence
Hugging Face API On‑demand AI summarization (Falcon‑7B-Instruct)

AI logic favors: deterministic structure, safe tone, non‑diagnostic phrasing, contextual heuristics (keyword extraction) to improve recommendations even without remote model.

🛠 Tech Stack

  • React 18 + TypeScript
  • Vite build tool
  • Tailwind CSS + @tailwindcss/typography
  • Framer Motion
  • React Router 6
  • Lucide icons
  • Firebase (Auth + Firestore)
  • Hugging Face Inference API (Falcon‑7B‑Instruct)

🧭 Usage Flow

  1. Start on the home page - Experience the welcoming parallax design
  2. Click "Start Logging Symptoms" to access the dashboard
  3. Optional: Sign in with Google to save data to the cloud
  4. Log your symptoms using the intuitive form:
    • Describe what happened
    • Rate severity (1-10) with visual indicators
    • Select potential trigger
  5. View your entries in the organized card grid
  6. Generate AI-powered reports to share with healthcare providers
  7. Copy or download reports for easy sharing

Data Persistence Modes

  • Anonymous: browser localStorage only
  • Authenticated: Firestore primary + local fallback if network fails
  • Intelligent fallback prevents data loss

Built with care for people managing chronic conditions.

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages