UltimateHealth Web is a web platform designed to empower wellness through community-driven health content. Migrated from a static foundation to a modern React ecosystem, it serves as the central hub for articles, podcasts, and moderator collaborations.
- Discovery: Advanced search with debounced filtering and infinite scroll.
- Rich Reading Experience: High-fidelity article renderer with multi-language support.
- Engagement: Authenticated comment sections, social sharing, and author attribution.
- Personalized Dashboards: Analytics for contributors showing impact and engagement.
- Profile Management: Customizable avatars, biographies, and notification settings.
- Secure Onboarding: OTP-verified registration and robust authentication flows.
- Frontend: React + TypeScript
- Build Tool: Vite
- Styling: Tailwind CSS & Glassmorphic CSS
- State Management: Zustand
- Routing: React Router Dom
- Real-time: Socket.IO
- Analytics: Custom dashboard with HSL-themed charts.
- Node.js (v18 or higher)
- npm or yarn
-
Clone the repository:
git clone https://github.com/your-repo/ultimatehealth-web.git cd ultimatehealth-web -
Install dependencies:
npm install
-
Environment Setup: Create a
.envfile in the root directory and add your API endpoints:VITE_API_BASE_URL=https://api.ultimatehealth.com VITE_SOCKET_URL=https://socket.ultimatehealth.com
-
Start the development server:
npm run dev
src/
├── assets/ # Global images and static assets
├── components/ # Atomic UI components (Buttons, Inputs, Modals)
├── contexts/ # React Contexts (Socket, Auth)
├── hooks/ # Custom React hooks
├── layouts/ # Page wrappers and navigation
├── pages/ # Main route components
├── services/ # API clients and socket management
├── store/ # Zustand stores
└── utils/ # Helper functions and constants
The project is currently undergoing a phased migration to React:
- Phase 1-2: Core Infrastructure & Design System
- Phase 3: Premium Landing Page Rebuild
- Phase 4-5: Article Hub & Content Renderer
- Phase 6-7: Authentication & User Profiles
- Phase 8-9: Admin Tools & Performance Optimization
We welcome contributions from wellness enthusiasts and developers alike! Please read our Moderator Agreement if you are looking to join our moderation team.
- Fork the Project
- Create your Feature Branch (
git checkout -b feature/AmazingFeature) - Commit your Changes (
git commit -m 'Add some AmazingFeature') - Push to the Branch (
git push origin feature/AmazingFeature) - Open a Pull Request
Distributed under the MIT License. See LICENSE for more information.
Built with ❤️ by the UltimateHealth Team