Skip to content
This repository was archived by the owner on Jul 7, 2026. It is now read-only.

ChanMeng666/sanicle-ai-mobile

Repository files navigation

🌸 Sanicle FemTech Mobile
AI-Powered Workplace Wellness for Women

Important

This is a comprehensive mobile web application designed specifically for workplace female health management. It combines period tracking, menopause support, health analytics, company wellness policies, and AI-powered health assistance in a unified platform optimized for mobile devices.

🌟 Introduction

A revolutionary mobile-first web application that transforms workplace wellness for women. This comprehensive FemTech platform provides personalized health tracking, cycle management, workplace integration, AI-powered insights, and company policy management. Built with modern web technologies and optimized for mobile devices, it delivers a seamless experience for both employees and HR departments.

Note

  • Mobile-first responsive design
  • Progressive Web App (PWA) ready
  • Offline capability support
  • iOS-style UI/UX design
  • Cross-platform compatibility
  • Enterprise-grade security

πŸš€ Visit Live Site πŸš€


✨ Key Features

🎯 Employee-Centric Health Management

  • Personal health dashboard with cycle insights
  • Period and ovulation tracking with predictions
  • Mood and symptom monitoring
  • Personalized health recommendations

πŸ“Š Advanced Health Analytics

  • Real-time health metrics visualization
  • Trend analysis and pattern recognition
  • Cycle phase-based insights
  • Interactive charts and graphs

πŸ€– AI-Powered Health Assistant

  • Conversational health guidance
  • Personalized recommendations
  • Symptom analysis and insights
  • 24/7 intelligent support

🏒 Workplace Integration

  • Work calendar with health awareness
  • Task scheduling based on cycle phases
  • Team collaboration features
  • Flexible work arrangement tools

πŸ“š Table of Contents

πŸ› οΈ Tech Stack

HTML5
HTML5
CSS3
CSS3
JavaScript
JavaScript
Tailwind CSS
Tailwind CSS
Chart.js
Chart.js
Font Awesome
Font Awesome

Tip

The tech stack is carefully chosen for optimal mobile performance, progressive enhancement, and cross-platform compatibility. The vanilla web approach ensures fast loading times and broad device support.

πŸ—οΈ Architecture Overview

Mobile-First Architecture

The application follows a mobile-first design philosophy with responsive layouts optimized for various screen sizes:

graph TD
    A[Mobile Web App] --> B[Responsive UI Layer]
    B --> C[Component System]
    B --> D[Navigation System]
    
    C --> E[Health Modules]
    C --> F[Workplace Modules]
    C --> G[Analytics Modules]
    
    D --> H[Tab Navigation]
    D --> I[Page Routing]
    
    E --> J[Period Tracking]
    E --> K[Health Stats]
    E --> L[AI Assistant]
    
    F --> M[Work Calendar]
    F --> N[HR Dashboard]
    F --> O[Company Policies]
Loading

Component Structure

Built with modular HTML components and reusable CSS classes:

  • Page Templates: Consistent layout structure across all screens
  • UI Components: Reusable cards, buttons, forms, and navigation elements
  • Design System: Comprehensive CSS variables and utility classes
  • Interactive Elements: JavaScript-enhanced user interactions

Data Flow Architecture

sequenceDiagram
    participant U as User
    participant UI as UI Layer
    participant LS as Local Storage
    participant AI as AI Assistant
    participant A as Analytics
    
    U->>UI: Health Data Input
    UI->>LS: Store Data Locally
    LS->>A: Process Analytics
    A->>AI: Generate Insights
    AI->>UI: Display Recommendations
    UI->>U: Updated Dashboard
Loading

πŸ“‚ Project Structure

sanicle-ai-mobile/
β”œβ”€β”€ app/
β”‚   β”œβ”€β”€ css/
β”‚   β”‚   └── sanicle-ui.css          # Comprehensive design system
β”‚   └── pages/
β”‚       β”œβ”€β”€ template.html           # Base template for all pages
β”‚       β”œβ”€β”€ employee-dashboard.html # Personal health dashboard
β”‚       β”œβ”€β”€ period-calendar.html    # Menstrual cycle tracking
β”‚       β”œβ”€β”€ work-calendar.html      # Workplace integration
β”‚       β”œβ”€β”€ health-events.html      # Company wellness events
β”‚       β”œβ”€β”€ health-stats.html       # Analytics and insights
β”‚       β”œβ”€β”€ ai-assistant.html       # AI health assistant
β”‚       β”œβ”€β”€ health-policies.html    # Company health policies
β”‚       β”œβ”€β”€ hr-dashboard.html       # HR management interface
β”‚       β”œβ”€β”€ hr-analytics.html       # HR analytics and reporting
β”‚       └── profile-settings.html   # User account management
β”œβ”€β”€ public/
β”‚   └── img/
β”‚       └── sanicle_logo.svg       # Brand assets
β”œβ”€β”€ index.html                     # Main demo showcase
β”œβ”€β”€ README.md                      # Project documentation
└── LICENSE                       # MIT License

πŸš€ Getting Started

Prerequisites

Important

Ensure you have the following:

  • Modern web browser (Chrome, Firefox, Safari, Edge)
  • Local web server for development
  • Git for version control
  • Code editor (VS Code recommended)

Quick Start Installation

1. Clone the Repository:

# Clone the repository
git clone https://github.com/ChanMeng666/sanicle-ai-mobile.git
cd sanicle-ai-mobile

2. Serve the Application:

# Using Python's built-in server
python -m http.server 8000

# Or using Node.js live-server
npm install -g live-server
live-server

# Or using VS Code Live Server extension
# Open project in VS Code and use Live Server

3. Access the Application:

Local Development

Development Workflow:

# Start development server
npm run dev

# Or use any static file server
# The app is pure HTML/CSS/JS - no build process required

# For mobile testing, use ngrok for external access
ngrok http 8000

πŸ“± Application Modules

Employee Dashboard

Features:

  • Personal health overview with cycle progress
  • Health metrics visualization
  • Personalized recommendations
  • Quick access to all features

Key Components:

  • Cycle progress indicator
  • Health metrics cards
  • Recommendation panels
  • Navigation shortcuts

Health Tracking

Period Calendar:

  • Interactive calendar with cycle visualization
  • Period prediction and tracking
  • Fertility window indicators
  • Mood and symptom logging

Health Stats:

  • Comprehensive analytics dashboard
  • Trend analysis and insights
  • Cycle phase correlations
  • Performance metrics

Workplace Integration

Work Calendar:

  • Integrated work and health scheduling
  • Task prioritization based on cycle phases
  • Team collaboration features
  • Flexible work arrangement tools

HR Dashboard:

  • Employee wellness overview
  • Policy management
  • Analytics and reporting
  • Team health insights

AI Assistant

Conversational Interface:

  • Natural language health queries
  • Personalized advice and recommendations
  • Symptom analysis and guidance
  • 24/7 intelligent support

Smart Features:

  • Context-aware responses
  • Learning from user patterns
  • Proactive health suggestions
  • Educational content delivery

🎨 Design System

The application uses a comprehensive design system built with CSS custom properties:

Color Palette:

:root {
  --primary: #167d83;      /* Sanicle teal */
  --accent: #EE4C23;       /* Energetic orange */
  --success: #10B981;      /* Success green */
  --warning: #F59E0B;      /* Warning amber */
  --destructive: #EF4444;  /* Error red */
}

Typography System:

  • Font Family: Apple system fonts for native feel
  • Scale: Harmonious type scale for mobile readability
  • Hierarchy: Clear information hierarchy

Component Library:

  • Cards, buttons, forms, navigation
  • Interactive elements and animations
  • Responsive grid system
  • Accessibility-compliant design

πŸ“– Development Guide

Adding New Features

1. Create New Page:

<!-- app/pages/new-feature.html -->
<!DOCTYPE html>
<html lang="en">
<head>
    <!-- Copy head from template.html -->
</head>
<body>
    <!-- iOS Status Bar -->
    <div class="status-bar">
        <div>9:41</div>
        <div>
            <span class="mr-2"><i class="fas fa-signal"></i></span>
            <span class="mr-2"><i class="fas fa-wifi"></i></span>
            <span><i class="fas fa-battery-full"></i></span>
        </div>
    </div>
    
    <!-- Navigation Bar -->
    <div class="nav-bar">
        <div class="text-xl font-semibold">Feature Name</div>
        <div>
            <i class="fas fa-bell text-gray-500 mr-4"></i>
            <i class="fas fa-cog text-gray-500"></i>
        </div>
    </div>
    
    <!-- Main Content -->
    <div class="content">
        <!-- Your feature content here -->
    </div>
    
    <!-- Tab Bar -->
    <div class="tab-bar">
        <!-- Copy tab navigation from template -->
    </div>
</body>
</html>

2. Update Navigation:

Add the new feature to the main index.html demo and update tab navigation across pages.

Customizing the UI

Modify Design System:

/* app/css/sanicle-ui.css */
:root {
  /* Update color variables */
  --primary: #your-color;
  --accent: #your-accent;
  
  /* Modify component styles */
  .card {
    /* Custom card styling */
  }
}

Add New Components:

.new-component {
  background-color: var(--background);
  border-radius: 16px;
  padding: 16px;
  box-shadow: 0 2px 10px rgba(0,0,0,0.05);
}

Performance Optimization

Mobile Optimization:

  • Optimize images and assets
  • Implement lazy loading
  • Use CSS transforms for animations
  • Minimize JavaScript bundle size

Progressive Enhancement:

  • Core functionality without JavaScript
  • Enhanced experience with JS enabled
  • Offline capability with service workers
  • Progressive Web App features

πŸš€ Deployment

Static Hosting

Vercel Deployment:

# Install Vercel CLI
npm i -g vercel

# Deploy
vercel

# Custom domain
vercel --prod

Netlify Deployment:

# Drag and drop deployment
# Or connect GitHub repository for continuous deployment

Progressive Web App

Add PWA Manifest:

{
  "name": "Sanicle FemTech Mobile",
  "short_name": "Sanicle",
  "description": "Workplace wellness for women",
  "start_url": "/",
  "display": "standalone",
  "background_color": "#167d83",
  "theme_color": "#167d83",
  "icons": [
    {
      "src": "/icon-192.png",
      "sizes": "192x192",
      "type": "image/png"
    }
  ]
}

Service Worker:

// sw.js
self.addEventListener('install', (event) => {
  event.waitUntil(
    caches.open('sanicle-v1').then((cache) => {
      return cache.addAll([
        '/',
        '/app/css/sanicle-ui.css',
        '/app/pages/employee-dashboard.html'
      ]);
    })
  );
});

Enterprise Deployment

Security Considerations:

  • HTTPS enforcement
  • Content Security Policy
  • Access control and authentication
  • Data privacy compliance

Scalability:

  • CDN configuration
  • Performance monitoring
  • Error tracking
  • Analytics integration

🀝 Contributing

We welcome contributions to Sanicle FemTech Mobile! Here's how you can help:

Development Process:

  1. Fork and Clone:
git clone https://github.com/ChanMeng666/sanicle-ai-mobile.git
cd sanicle-ai-mobile
  1. Create Feature Branch:
git checkout -b feature/amazing-new-feature
  1. Development Guidelines:
  • βœ… Follow mobile-first design principles
  • βœ… Maintain accessibility standards (WCAG 2.1)
  • βœ… Test on multiple devices and browsers
  • βœ… Use semantic HTML and proper CSS structure
  • βœ… Add comprehensive documentation
  1. Submit Pull Request:
  • Provide clear description of changes
  • Include screenshots for UI changes
  • Test thoroughly on mobile devices
  • Update documentation as needed

Issue Reporting:

  • πŸ› Bug reports with device/browser info
  • πŸ’‘ Feature requests with use cases
  • πŸ“š Documentation improvements
  • 🎨 UI/UX enhancements

πŸ“„ License

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

πŸ™‹β€β™€οΈ Author

Chan Meng - Senior AI/ML Infrastructure Engineer


🌸 Empowering Women's Workplace Wellness πŸ’–
Mobile-first health management for the modern workplace

⭐ Star us on GitHub | πŸ“– Read the Docs | πŸ› Report Issues | πŸ’‘ Request Features

GitHub stars GitHub forks GitHub watchers

Chan Meng

Chan Meng
Need a custom app like this one? I build them β€” let's talk.

Email Chan Meng Chan Meng on GitHub

About

【⭐️ Star this repo to support workplace wellness innovation!γ€‘πŸŒΈ Mobile-first FemTech web application built with HTML5, CSS3, JavaScript & Chart.js. Features AI health assistant, period tracking, workplace integration, HR analytics & comprehensive wellness monitoring with responsive design optimized for 90% mobile usage scenarios.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Releases

Sponsor this project

Packages

Contributors

Languages