Log inSign up
James_AI
James_AIUrbanWellnessApp
Public
Like
UrbanWellnessApp
Val Town is a collaborative website to build and scale JavaScript apps.
Deploy APIs, crons, & store data – all from the browser, and deployed in milliseconds.
Sign up now
Code
/
README.md
Search
6/2/2025
README.md

🌿 Sage of the City - Urban Wellness Guide

A friendly AI wellness guru designed to help busy urbanites find balance between productivity and personal well-being in the fast-paced city environment.

Features

  • Personalized Wellness Tips: Work-life balance, healthy eating, and mindfulness advice
  • Urban Nature Discovery: Recommendations for nearby parks, walking routes, and nature retreats
  • Daily Wellness Challenges: Quick 30-second to 2-minute wellness activities
  • Motivational Content: Inspiring quotes and calming ambient sound suggestions
  • Soothing AI Personality: Part life coach, part friend - always supportive and understanding

Project Structure

β”œβ”€β”€ backend/
β”‚   β”œβ”€β”€ index.ts           # Main Hono server
β”‚   └── routes/
β”‚       β”œβ”€β”€ wellness.ts    # Wellness advice and tips
β”‚       └── challenges.ts  # Daily wellness challenges
β”œβ”€β”€ frontend/
β”‚   β”œβ”€β”€ index.html         # Main app interface
β”‚   β”œβ”€β”€ index.tsx          # React frontend
β”‚   β”œβ”€β”€ components/
β”‚   β”‚   β”œβ”€β”€ App.tsx        # Main app component
β”‚   β”‚   β”œβ”€β”€ WellnessCard.tsx
β”‚   β”‚   └── ChallengeCard.tsx
β”‚   └── style.css          # Custom styling
└── shared/
    └── types.ts           # Shared TypeScript types

Usage

The Sage provides:

  • Personalized Wellness Advice: Chat with the Sage about your stress, work-life balance, or wellness needs
  • Daily Wellness Challenges: Get quick, actionable wellness activities (30 seconds to 5 minutes)
  • Urban Nature Discovery: Find parks, walking routes, and nature spots in your city
  • Customizable Preferences: Set your stress level, available time, and work environment
  • Motivational Support: Receive inspiring quotes and ambient sound suggestions

Key Features:

  • 🌿 Sage Chat Interface: Natural conversation with AI wellness guide
  • 🌱 Quick Action Buttons: Instant access to challenges and nature recommendations
  • βš™οΈ Preference Settings: Customize experience based on your needs
  • 🎯 Step-by-Step Challenges: Interactive wellness activities with progress tracking
  • πŸ’« Ambient Sound Suggestions: Recommendations for calming background audio

Tech Stack

  • Backend: Hono.js with TypeScript
  • Frontend: React with TypeScript
  • Styling: TailwindCSS with custom glass-morphism effects
  • AI: OpenAI GPT-4o-mini for personalized wellness advice
  • Fonts: Inter + Crimson Text for modern + sage-like typography
  • Animations: CSS keyframes for floating and fade-in effects

API Endpoints

  • POST /api/sage/advice - Get personalized wellness advice
  • POST /api/sage/challenge - Receive a daily wellness challenge
  • POST /api/sage/nature - Find urban nature spots and walking routes