Digital Nurse Buddy

Your AI-powered clinical companion — built by a nurse, for nurses.

🌐 Live App • Features • Tech Stack • Getting Started • Project Structure • Roadmap

---

App is now fully public-access with no login required. Every screen, workflow, and calculator loads instantly without credentials or backend dependencies.

Update: The access screen has been removed. The app now loads directly into the main workspace.

---

📋 Overview

Digital Nurse Buddy is an evidence-based clinical reference tool designed for ICU/ER nurses and nursing students. It delivers rapid access to procedures, lab values, drug calculators, ECG interpretation, flashcards, and AI-assisted guidance — all in a responsive, offline-ready interface.

Key Highlights

• Clinical Cockpit — Evidence-informed dashboards for procedures, labs, calculators, flashcards, and more.
• Offline-Friendly Data — All master data lives in src/data/*, so demos run without APIs or environment variables.
• Responsive Shell — shadcn/ui components, Lucide icons, and Tailwind CSS create a polished experience across mobile and desktop.
• AI Helper — The assistant responds locally with curated clinical guidance, keeping the UI helpful even without a model backend.
• ECG Module — Interactive ECG interpretation guide with rhythm identification and clinical pearls.
• PWA Support — Install as a native-like app on any device for instant access on the ward.

---

✨ Features

Module	Description
🏥 Procedures	Step-by-step guides for common ICU/ER procedures
🧪 Lab Values	Quick-reference normal ranges with clinical significance
💊 Drug Calculators	Dosing calculators for critical-care medications
💓 ECG Interpreter	Rhythm identification, axis deviation, and clinical pearls
🧠 Flashcards	Spaced-repetition study cards for NCLEX and clinical review
🤖 AI Assistant	Context-aware clinical Q&A powered by curated knowledge
📊 Clinical Dashboards	At-a-glance views for vitals, assessments, and workflows
📱 PWA / Offline	Works without internet — perfect for bedside use

---

🛠 Tech Stack

Layer	Technology
Frontend	React 18, TypeScript, Vite
UI	shadcn/ui, Tailwind CSS, Lucide Icons
Backend	Supabase (Auth, Database, Edge Functions)
Data	Local JSON (src/data/*) + Supabase tables
Deployment	Lovable.dev (CI/CD)
PWA	Vite PWA Plugin, Service Worker

---

🚀 Getting Started

Prerequisites

• Node.js ≥ 18
• npm or yarn

Installation

# Clone the repository
git clone https://github.com/3h0ll7/digitalnurse.git
cd digitalnurse

# Install dependencies
npm install

# Start the development server
npm run dev

The app will be available at http://localhost:5173.

Environment Variables

Copy the example file and configure as needed:

cp .env.example .env

Note: The app runs fully offline with local data. Supabase credentials are only needed for backend features (auth, sync, AI helper).

Variable	Description	Required
VITE_SUPABASE_URL	Supabase project URL	Optional
VITE_SUPABASE_ANON_KEY	Supabase anonymous key	Optional

---

📁 Project Structure

digitalnurse/
├── docs/                  # Documentation and design specs
├── public/                # Static assets (icons, manifest)
├── server/                # Server-side utilities
├── src/
│   ├── components/        # Reusable UI components
│   ├── data/              # Local clinical data (JSON)
│   ├── hooks/             # Custom React hooks
│   ├── lib/               # Utility functions
│   ├── pages/             # Route-level page components
│   └── styles/            # Global styles and Tailwind config
├── supabase/              # Supabase migrations and config
├── .env.example           # Environment variable template
├── TODO_ROADMAP.md        # Development roadmap
└── README.md              # ← You are here

---

🗺 Roadmap

See TODO_ROADMAP.md for the full development roadmap.

Upcoming priorities:

• Expanded drug database with interaction checker
• Ventilator settings quick-reference
• Arabic language support (RTL)
• Multi-patient tracker for shift handoffs
• NCLEX-RN practice exam mode
• Community-contributed flashcard decks

---

🤝 Contributing

Contributions are welcome! Whether it's a bug fix, new clinical module, or UI improvement:

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

---

📄 License

This project is licensed under the MIT License — see the LICENSE file for details.

---

👤 Author

Hassan Salman — ICU Nurse & Developer

• 🏥 Building clinical tools at the intersection of nursing and AI
• 🌐 Brand: Digital Nurse Buddy
• 🔗 GitHub: @3h0ll7

---

Built with ❤️ at the nursing station — between alarms and assessments.