Skip to content

ChanMeng666/femtech-weekend-website

Repository files navigation

Project Banner

🚀 FemTech Weekend Platform

Empowering Women's Health Innovation in China & Globally

A comprehensive production-ready platform for FemTech Weekend - China's first organization focusing on women's health technology challenges.
Built with modern web technologies, supporting competition management, ecosystem directory, research insights, and global community building.
One-click FREE deployment of your FemTech innovation platform.

Official Site · Live Platform · Documentation · Competition · Issues


🚀 Visit Live Platform 🚀



[][github-action-test-link] [][github-releasedate-link]

Share FemTech Weekend Platform

🌟 Pioneering the future of women's health technology. Built for the next generation of FemTech innovators.

📸 Platform Screenshots

[!TIP] Experience the power of our comprehensive FemTech platform designed for innovation, community, and research.

Research Reports Ecosystem Directory

Research Reports Hub and Strategic Partnerships

Tech Stack Badges:

Important

This project demonstrates modern full-stack development practices for FemTech innovation platforms. It combines Docusaurus with React components, serverless APIs, and headless CMS to provide comprehensive competition management, ecosystem building, and research dissemination capabilities.

📑 Table of Contents

TOC


🌟 Introduction

We are passionate developers creating the future of women's health technology innovation. FemTech Weekend is China's first organization focusing on women's health technology challenges, dedicated to widely spreading advanced FemTech concepts and fostering global collaboration in women's health innovation.

This platform serves as the comprehensive digital hub for:

  • Competition Management: Hosting China's premier FemTech hackathons and innovation challenges
  • Ecosystem Building: Connecting 200+ founders, investors, corporates, and healthcare professionals
  • Research Dissemination: Publishing cutting-edge insights on women's health technology trends
  • Global Bridge: Facilitating China-international FemTech collaboration and knowledge exchange

Note

  • Node.js >= 18.0 required
  • Notion API access required for content management
  • Cloudinary account recommended for image uploads
  • Bilingual support (English/Chinese) built-in
Experience our live platform with competition registration and ecosystem directory.
Join our FemTech community! Connect with innovators, investors, and healthcare professionals.

Tip

⭐ Star us to stay updated with the latest FemTech innovations and platform releases!

✨ Key Features

1 Competition Management Platform

Experience next-generation hackathon and competition management. Our innovative platform provides comprehensive tools for organizing, managing, and showcasing FemTech innovation challenges that drive women's health technology forward.

Key capabilities include:

  • 🏆 Multi-Stage Competitions: Registration, submission, judging, and showcase workflows
  • 📊 Real-time Analytics: Track participation, engagement, and impact metrics
  • 🌐 Bilingual Support: Full English/Chinese localization for global participation
  • 🔗 Integration Ready: Seamless connection with judging platforms and communication tools

2 Ecosystem Directory & Community

Revolutionary community platform that transforms how FemTech stakeholders connect and collaborate. With our comprehensive member directory and networking tools, users can discover opportunities, find partners, and build the future of women's health together.

Available Categories:

  • FemTech Founders: Entrepreneurs building women's health solutions
  • Investors & VCs: Funding partners focused on FemTech investments
  • Healthcare Professionals: Medical experts and practitioners
  • Academic Researchers: Scientists and researchers advancing women's health
  • Corporate Partners: Companies supporting FemTech innovation

3 Research & Insights Hub

Comprehensive research platform delivering investment-grade insights on FemTech market trends, innovation patterns, and strategic opportunities across China and global markets.

Research Areas:

  • 📈 Market Analysis: FemTech market maps and trend reports
  • 💰 Investment Insights: Funding data and investor landscape analysis
  • 🔬 Technology Trends: AI, digital health, and emerging tech in women's health
  • 🌏 Regional Focus: Greater China market with global perspectives

* Additional Features

Beyond the core platform, FemTech Weekend includes:

  • 🚀 One-Click Deployment: Deploy your own FemTech platform in minutes
  • 🌐 International Ready: Full bilingual support with cultural adaptation
  • 🔒 Privacy Focused: Secure data handling with GDPR compliance
  • 💎 Modern UI/UX: Beautiful design optimized for women's health community
  • 📱 Mobile Responsive: Perfect experience across all devices
  • 📊 Analytics Dashboard: Comprehensive insights on community engagement
  • 🔌 API Integration: Notion CMS, Cloudinary, and third-party services
  • 📈 SEO Optimized: Search engine optimization for maximum visibility

✨ More features are continuously being added as the FemTech ecosystem evolves.

🛠️ Tech Stack

Docusaurus
Docusaurus 3.7
React
React 18
TypeScript
TypeScript 5
TailwindCSS
Tailwind CSS
Notion
Notion API
Cloudinary
Cloudinary
Cloudflare
Cloudflare Pages

Frontend Stack:

  • Framework: Docusaurus 3.7 with React 18
  • Language: TypeScript for type safety
  • Styling: TailwindCSS + Custom Design System
  • UI Components: Radix UI + Custom FemTech Components
  • Animations: GSAP + Framer Motion

Backend & Content:

  • API: Serverless functions on Cloudflare Pages
  • CMS: Notion as headless content management
  • Media: Cloudinary for optimized image delivery
  • Search: Algolia for powerful site search
  • Analytics: Integrated tracking and insights

DevOps & Deployment:

  • Platform: Cloudflare Pages with global CDN
  • CI/CD: GitHub Actions automation
  • Monitoring: Performance and error tracking
  • Internationalization: Built-in i18n support

Tip

Each technology was carefully selected for production readiness, developer experience, and scalability in the FemTech innovation space.

🏗️ Architecture

System Architecture

graph TB
    subgraph "Frontend Layer"
        A[Docusaurus App] --> B[React Components]
        B --> C[UI Components]
        C --> D[API Integration]
    end
    
    subgraph "Content & Data"
        E[Notion CMS] --> F[Competition Data]
        F --> G[Ecosystem Directory]
        G --> H[Research Reports]
    end
    
    subgraph "API Layer"
        I[Serverless Functions]
        J[Form Submissions]
        K[Image Upload]
        L[Content Sync]
    end
    
    subgraph "External Services"
        M[Cloudinary]
        N[Algolia Search]
        O[Analytics]
    end
    
    D --> I
    I --> E
    I --> M
    A --> N
    A --> O
    
    subgraph "Deployment"
        P[Cloudflare Pages]
        Q[Global CDN]
        R[Auto Scaling]
    end
    
    A --> P
    P --> Q
    Q --> R
Loading

Content Management Flow

sequenceDiagram
    participant U as User
    participant F as Frontend
    participant A as API
    participant N as Notion
    participant C as Cloudinary
    
    U->>F: Submit Form/Content
    F->>A: API Request
    A->>C: Upload Images (if any)
    C->>A: Return Image URLs
    A->>N: Create/Update Content
    N->>A: Confirmation
    A->>F: Success Response
    F->>U: Update UI
Loading

Component Structure

src/
├── components/           # React UI components
│   ├── AboutUs/         # About page components
│   ├── Competition/     # Competition management
│   ├── Ecosystem/       # Community directory
│   ├── Reports/         # Research hub
│   └── ui/              # Reusable UI components
├── data/                # Static data and configurations
├── constants/           # Application constants
├── types/               # TypeScript definitions
├── utils/               # Utility functions
└── pages/               # Main application pages

⚡️ Performance

Key Metrics

Lighthouse Scores:

  • Performance: 95+ score across all pages
  • Accessibility: 100 score with WCAG compliance
  • 🎯 Best Practices: 100 score with security headers
  • 🔍 SEO: 100 score with optimized meta tags

Platform Performance:

  • 🚀 < 2s Page load times globally
  • 💨 < 500ms API response times
  • 📊 99.9% Uptime reliability
  • 🔄 Real-time content synchronization

Optimization Features:

  • 🎯 Smart Caching: Multi-layer caching strategy
  • 📦 Code Splitting: Automatic bundle optimization
  • 🖼️ Image Optimization: Cloudinary with WebP support
  • 🌐 CDN: Global content delivery network

🚀 Getting Started

Prerequisites

Important

Ensure you have the following installed:

  • Node.js 18.0+ (Download)
  • npm/yarn/pnpm package manager
  • Git (Download)
  • Notion account and API token
  • Cloudinary account (optional, for image uploads)

Quick Installation

1. Clone Repository

git clone https://github.com/ChanMeng666/femtech-weekend-website.git
cd femtech-weekend-website

2. Install Dependencies

# Using npm
npm install

# Using yarn
yarn install

# Using pnpm (recommended)
pnpm install

3. Environment Setup

# Copy environment template
cp .env.example .env.local

# Edit environment variables
nano .env.local

4. Start Development

# Start development server
npm run dev

# Or start with API server
npm run dev

🎉 Success! Open http://localhost:3000 to view the platform.

Environment Setup

  1. Copy the environment template:
cp .env.example .env.local
  1. Edit .env.local with your actual credentials:
# Notion Configuration
NOTION_TOKEN="your_notion_integration_token"
NOTION_DATABASE_ID="your_main_database_id"
PDF_FORM_DATABASE_ID="your_pdf_form_database_id"

# Cloudinary Configuration (Optional)
CLOUDINARY_CLOUD_NAME="your_cloud_name"
CLOUDINARY_API_KEY="your_api_key"
CLOUDINARY_API_SECRET="your_api_secret"

# Google Gemini AI Configuration (Required for AI Chatbot)
GOOGLE_GENERATIVE_AI_API_KEY="your_gemini_api_key"

# Environment
NODE_ENV="development"

⚠️ Security Note: Never commit .env.local to version control. See SECURITY.md for detailed security guidelines.

Development Mode

# Development with hot reload
npm run start

# API server (if needed separately)
npm run api

# Full development stack
npm run dev

# Build for production
npm run build

# Type checking
npm run typecheck

🛳 Deployment

Important

The platform is deployed on Cloudflare Pages with global CDN distribution.

A Cloudflare Pages Deployment

Deployment:

The site is automatically deployed via Cloudflare Pages when changes are pushed to the main branch.

Manual Build:

# Build for production
npm run build

B Environment Variables

Warning

Never commit sensitive environment variables to version control. Use Cloudflare Pages' environment variables settings for production deployment.

Variable Description Required Example
NOTION_TOKEN Notion integration token secret_xxxxxxxxxxxxx
NOTION_DATABASE_ID Main ecosystem database ID xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
PDF_FORM_DATABASE_ID PDF form submissions database xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
CLOUDINARY_CLOUD_NAME Cloudinary account name 🔶 your-cloud-name
CLOUDINARY_API_KEY Cloudinary API key 🔶 123456789012345
CLOUDINARY_API_SECRET Cloudinary API secret 🔶 your-api-secret
NODE_ENV Environment mode 🔶 production

Note

✅ Required, 🔶 Optional

📖 Usage Guide

Competition Management

Getting Started with Competitions:

  1. Access Competition Dashboard via /competition
  2. Register for Events through the integrated form system
  3. Track Progress with real-time updates and notifications
  4. Submit Projects via the submission portal

Ecosystem Directory

Join the FemTech Community:

  1. Browse Members at /ecosystem to discover founders, investors, and partners
  2. Apply to Join using the comprehensive application form at /ecosystem/join
  3. Network & Connect with like-minded FemTech professionals
  4. Access Resources including research reports and market insights

API Reference

Tip

All API endpoints support JSON format and include proper error handling and validation.

Form Submission Endpoints:

# Ecosystem membership application
POST /api/submit-ecosystem
Content-Type: application/json

{
  "name": "Jane Doe",
  "email": "jane@example.com",
  "companyName": "HealthTech Innovations",
  "companyWebsite": "https://healthtech.com",
  "founderName": "Jane Doe",
  "businessDescription": "AI-powered women's health platform",
  "businessStage": "Series A",
  "categories": ["AI/ML", "Digital Health"]
}

# PDF download with form collection
POST /api/pdf-form-submit
Content-Type: application/json

{
  "firstName": "Jane",
  "lastName": "Doe", 
  "email": "jane@example.com",
  "company": "Tech Corp",
  "website": "https://techcorp.com",
  "country": "China",
  "pdfUrl": "https://example.com/report.pdf"
}

# Image upload to Cloudinary
POST /api/upload-image
Content-Type: multipart/form-data

FormData:
- file: [image file]
- folder: "ecosystem" (optional)

🔌 Integrations

We support integration with leading platforms and services:

Category Service Status Documentation
Content Management Notion API ✅ Active Setup Guide
Media Storage Cloudinary ✅ Active Setup Guide
Search Algolia ✅ Active Setup Guide
Analytics Google Analytics ✅ Active Setup Guide
Deployment Cloudflare Pages ✅ Active Setup Guide
Monitoring Sentry 🔶 Optional Setup Guide

📊 Total integrations: 10+

⌨️ Development

Local Development

Setup Development Environment:

# Clone repository
git clone https://github.com/ChanMeng666/femtech-weekend-website.git
cd femtech-weekend-website

# Install dependencies
npm install

# Setup environment
cp .env.example .env.local

# Start development
npm run dev

Development Scripts:

# Development
npm run start        # Start Docusaurus dev server
npm run api          # Start API server
npm run dev          # Start both servers concurrently

# Building
npm run build        # Production build
npm run serve        # Preview build locally
npm run clear        # Clear build cache

# Quality
npm run typecheck    # TypeScript validation
npm run swizzle      # Customize Docusaurus components

# Localization
npm run write-translations    # Generate translation files
npm run write-heading-ids     # Generate heading IDs

Adding Features

1. Create Feature Structure:

# Add new component
mkdir src/components/NewFeature
touch src/components/NewFeature/index.tsx
touch src/components/NewFeature/README.md

2. Feature Development Guidelines:

  • ✅ Follow TypeScript best practices
  • ✅ Add comprehensive documentation
  • ✅ Include internationalization support
  • ✅ Follow accessibility guidelines
  • ✅ Add proper error handling

Internationalization

The platform supports full bilingual functionality:

Adding New Translations:

// i18n/en/code.json
{
  "newFeature.title": "New Feature Title",
  "newFeature.description": "Feature description"
}

// i18n/zh-Hans/code.json  
{
  "newFeature.title": "新功能标题",
  "newFeature.description": "功能描述"
}

Usage in Components:

import { translate } from '@docusaurus/Translate';

const title = translate({
  id: 'newFeature.title',
  message: 'Default Title',
});

🤝 Contributing

We welcome contributions to the FemTech Weekend platform! Here's how you can help improve this project:

Development Process

1. Fork & Clone:

git clone https://github.com/ChanMeng666/femtech-weekend-website.git
cd femtech-weekend-website

2. Create Branch:

git checkout -b feature/your-feature-name

3. Make Changes:

  • Follow our coding standards
  • Add tests for new features
  • Update documentation as needed
  • Ensure all tests pass

4. Submit PR:

  • Provide clear description
  • Include screenshots for UI changes
  • Reference related issues
  • Ensure CI passes

Contribution Guidelines

Code Style:

  • Use TypeScript for type safety
  • Follow ESLint and Prettier configuration
  • Write meaningful commit messages
  • Add JSDoc comments for public APIs

Pull Request Process:

  1. Update README.md if needed
  2. Add tests for new functionality
  3. Ensure all tests pass
  4. Request review from maintainers

Issue Reporting:

  • 🐛 Bug Reports: Include reproduction steps
  • 💡 Feature Requests: Explain use case and benefits
  • 📚 Documentation: Help improve our docs
  • Questions: Use GitHub Discussions

📄 License

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

Open Source Benefits:

  • ✅ Commercial use allowed
  • ✅ Modification allowed
  • ✅ Distribution allowed
  • ✅ Private use allowed

👥 Team

Chan Meng
Chan Meng

Platform Developer & Technical Lead
Zhu Yihan
Zhu Yihan
Founder & CEO, FemTech Weekend

Contact Information:

Developer Contact:


🚀 Empowering Women's Health Innovation 🌟
Rooted in China, Connecting Globally

Star us on GitHub • 📖 Read the Documentation • 🐛 Report Issues • 💡 Request Features • 🤝 Contribute



Made with ❤️ by the FemTech Weekend team

GitHub stars GitHub forks

About

【Be the reason someone's repo counter goes up today! ⭐️】Built with Docusaurus, React & TypeScript. Features bilingual support, 200+ member ecosystem, competition management, and Notion CMS integration. Connecting China's FemTech community globally.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Sponsor this project

Packages

 
 
 

Contributors