Skip to content

RedjiJB/drone-Zoe

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐Ÿš Drone Zoe - Democratizing Drone Technology Through Cooperative Investment

Status Deployment License Next.js

Live Site: https://dronezoe.net


๐ŸŒŸ About Drone Zoe

Drone Zoe is a revolutionary cooperative investment platform designed to democratize access to drone technology through community ownership and shared prosperity. Currently in development phase, we're building a platform that will enable micro-investments starting from just 131 HTG ($1) to participate in Haiti's drone technology revolution.

๐ŸŽฏ Mission

To create a cooperative ecosystem where individuals can pool resources to collectively own and benefit from advanced drone technology, fostering economic development and technological advancement in Haiti and beyond.

๐Ÿ”‘ Key Features

  • Complete Hardware Platform: 13+ drone platforms across 4 tiers with 94-98% cost savings
  • Open Source Sensor System: Modular sensor platform with 3D printable housings
  • Micro-Investment System: Start investing from just 131 HTG ($1)
  • Cooperative Ownership: Democratic governance and shared returns
  • Fractional Equipment Ownership: Own shares of specific drone components
  • Service Revenue Sharing: Participate in drone service profits
  • Blockchain Transparency: Verifiable ownership and transactions
  • Community Governance: Member voting on key decisions
  • Flightory Integration: Professional fixed-wing aircraft with 75-85% local content
  • Technological Sovereignty: Complete local manufacturing capability

๐Ÿš€ Production Deployment

Live Website

  • Primary URL: https://dronezoe.net
  • Status: โœ… Live and accessible
  • Deployment: Automated via GitHub Actions
  • Hosting: GitHub Pages with CDN
  • SSL: Automatic HTTPS

Deployment Architecture

โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”    โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”    โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
โ”‚   Developer     โ”‚    โ”‚   GitHub Actions โ”‚    โ”‚  GitHub Pages   โ”‚
โ”‚   Push to Main  โ”‚โ”€โ”€โ”€โ–ถโ”‚   Build & Deploy โ”‚โ”€โ”€โ”€โ–ถโ”‚   Live Website  โ”‚
โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜    โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜    โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
                              โ”‚                          โ”‚
                              โ–ผ                          โ–ผ
                       โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”         โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
                       โ”‚ Build Status โ”‚         โ”‚  dronezoe.net   โ”‚
                       โ”‚   Monitoring โ”‚         โ”‚  Custom Domain  โ”‚
                       โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜         โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜

๐Ÿ› ๏ธ Technology Stack

Frontend Framework

  • Next.js 15.3.2: React framework with static export
  • React 19.1.0: User interface library
  • TypeScript: Type-safe development
  • Tailwind CSS 4: Utility-first styling

Animation & Interactions

  • Motion: Advanced animations and interactions
  • Framer Motion Components: Rich motion library
  • Custom UI Components: Specialized animations

Development & Deployment

  • GitHub Actions: CI/CD pipeline
  • GitHub Pages: Static site hosting
  • ESLint & Prettier: Code quality and formatting
  • PostCSS: CSS processing

Tools & Integrations

  • Shadcn/ui: Component library foundation
  • Lucide Icons: Icon system
  • Custom Registry: Component management system

๐Ÿš€ Quick Start Development

One-Line Setup & Run

# First time setup (run once)
./setup.sh

# Start development server
./dev.sh

Manual Setup

# Install dependencies
npm install
cd apps/www && npm install && cd ../..

# Start development server
npm run dev          # All apps with Turbo
npm run dev:www      # Website only

Available Commands

  • ./dev.sh - Easy development server with auto-setup
  • ./setup.sh - One-time project setup
  • ./dashboard.sh - Interactive multi-service dashboard launcher
  • ./launch-cooperative-dashboards.sh - ๐Ÿš€ Unified dashboard and site launcher with consistent naming

New Unified Dashboard System โญ Enhanced

# Dashboard Commands (role-dashboard pattern)
./launch-cooperative-dashboards.sh organization-admin-dashboard   # Port 3007
./launch-cooperative-dashboards.sh member-dashboard              # Port 3009  
./launch-cooperative-dashboards.sh cooperative-manager-dashboard # Port 3010
./launch-cooperative-dashboards.sh system-admin-dashboard        # Port 3008

# Site Commands (project-site pattern)
./launch-cooperative-dashboards.sh saas-site                     # Port 3004
./launch-cooperative-dashboards.sh drone-zoe-site               # Port 3011

# Utility Commands
./launch-cooperative-dashboards.sh all      # Launch all services
./launch-cooperative-dashboards.sh status   # Check service status
./launch-cooperative-dashboards.sh stop     # Stop all services
./launch-cooperative-dashboards.sh help     # Show help information

Legacy Commands

  • ./launch-dashboard.sh - Legacy dashboard launcher
  • npm run dev - Start all applications
  • npm run dev:www - Start website only (port 3002)
  • npm run dev:dashboard - Start dashboard only (port 3003)
  • npm run dev:saas - Start SaaS starter kit (port 3000)
  • npm run build - Build all applications
  • npm run build:www - Build website only

๐Ÿš Cooperative Dashboard System

The launch-cooperative-dashboards.sh script provides unified access to the complete cooperative platform with enhanced sidebar navigation and consistent naming conventions.

Enhanced Dashboard Architecture โญ

All dashboards feature comprehensive sidebar navigation with 8-9 organized sections:

  1. Organization Admin Dashboard (Port 3007) - Complete cooperative management

    • โœ… Comprehensive 9-Section Sidebar: Quick Access, Admin Dashboard, Organization Management, User Management, Financial Management, Analytics & Reports, System Settings, Support & Documentation, Account Settings
    • ๐ŸŒ™ Dark/Light Mode Toggle with smooth transitions and theme persistence
    • Advanced Navigation: JavaScript page switching, CSS animations, localStorage page memory
    • Management-Level Metrics: Organization oversight with comprehensive cooperative analytics
    • Title: "Organization Admin Dashboard - Haiti Drone Cooperative"
  2. Member Dashboard (Port 3009) - Personalized member interface

    • โœ… Comprehensive 8-Section Sidebar: Quick Access, Dashboard, Cooperative Features, Collaboration, Learning & Support, Account & Settings, Help & Documentation, Advanced Features
    • ๐ŸŒ™ Dark/Light Mode Toggle with smooth transitions and theme persistence
    • Personal-Level Navigation: Member-focused sections with "My" prefixed personal areas
    • Marie User Persona: marie@haitidronecooperative.com with personalized metrics
    • Title: "Member Dashboard - Haiti Drone Cooperative"
  3. Cooperative Manager Dashboard (Port 3010) - Management interface

    • โœ… Enhanced Sidebar Structure with role-specific management tools
    • Next.js Architecture with shadcn/ui components and modern design system
    • Title: "Cooperative Manager Dashboard - Haiti Drone Cooperative"
  4. System Admin Dashboard (Port 3008) - System administration

    • โœ… Administrative Control Panel with system-wide management capabilities
    • Comprehensive Admin Tools for platform oversight and maintenance

Site Platforms

  1. SaaS Site (Port 3004) - Software platform

    • Title: "SaaS Site - Haiti Drone Cooperative"
    • Description: "SaaS platform for Haiti Drone Cooperative - comprehensive software solution"
  2. Drone Zoe Site (Port 3011) - Public website

    • Main Public Interface with cooperative information and services

Interactive Dashboard System

The legacy dashboard.sh script provides access to 6 integrated platform services:

  1. Main App Dashboard (Port 3003) - Primary admin interface

    • Investment tracking and management
    • Equipment monitoring and performance metrics
    • Cooperative governance tools
    • Real-time operational dashboard
  2. SaaS Starter Dashboard (Port 3004) - Development tools interface

  3. Database Studio (Port 4983) - Data management interface

  4. API Documentation (Port 3000) - Development documentation

  5. All Dashboards - Launch all services simultaneously

  6. Quit - Exit launcher

Development URLs

Enhanced Cooperative Platform

Legacy System


๐Ÿ—๏ธ Project Structure

drone-Zoe/
โ”œโ”€โ”€ .github/
โ”‚   โ””โ”€โ”€ workflows/
โ”‚       โ””โ”€โ”€ deploy.yml           # GitHub Actions deployment
โ”œโ”€โ”€ apps/
โ”‚   โ””โ”€โ”€ www/                     # Main website application
โ”‚       โ”œโ”€โ”€ app/                 # Next.js app directory
โ”‚       โ”‚   โ”œโ”€โ”€ (app)/          # Main app routes
โ”‚       โ”‚   โ”‚   โ”œโ”€โ”€ (landing)/  # Landing page
โ”‚       โ”‚   โ”‚   โ”œโ”€โ”€ about/      # About page
โ”‚       โ”‚   โ”‚   โ”œโ”€โ”€ services/   # Services page
โ”‚       โ”‚   โ”‚   โ”œโ”€โ”€ invest/     # Investment page
โ”‚       โ”‚   โ”‚   โ”œโ”€โ”€ impact/     # Impact dashboard
โ”‚       โ”‚   โ”‚   โ”œโ”€โ”€ blog/       # Blog/content
โ”‚       โ”‚   โ”‚   โ”œโ”€โ”€ contact/    # Contact page
โ”‚       โ”‚   โ”‚   โ”œโ”€โ”€ partners/   # Partners page
โ”‚       โ”‚   โ”‚   โ”œโ”€โ”€ drone-platform/  # Drone platform section
โ”‚       โ”‚   โ”‚   โ”‚   โ””โ”€โ”€ designer/    # Custom drone designer
โ”‚       โ”‚   โ”‚   โ”œโ”€โ”€ api-platform/    # API platform section
โ”‚       โ”‚   โ”‚   โ””โ”€โ”€ docs/            # Documentation hub
โ”‚       โ”‚   โ”œโ”€โ”€ components/     # React components
โ”‚       โ”‚   โ”œโ”€โ”€ lib/           # Utilities and helpers
โ”‚       โ”‚   โ”œโ”€โ”€ docs/          # Markdown documentation
โ”‚       โ”‚   โ””โ”€โ”€ api-docs/      # Docusaurus API documentation
โ”‚       โ”‚   โ””โ”€โ”€ styles/        # Global styles
โ”‚       โ”œโ”€โ”€ public/            # Static assets
โ”‚       โ”œโ”€โ”€ components/        # Shared components
โ”‚       โ”œโ”€โ”€ config/           # Configuration files
โ”‚       โ””โ”€โ”€ registry/         # Component registry
โ”œโ”€โ”€ docs/                     # Documentation
โ”œโ”€โ”€ CHANGELOG.md             # Version history
โ”œโ”€โ”€ DEPLOYMENT.md           # Deployment guide
โ”œโ”€โ”€ ROADMAP.md             # Future plans
โ””โ”€โ”€ README.md             # This file

๐Ÿš€ Getting Started

Prerequisites

  • Node.js: 18.0.0 or higher
  • npm: 8.0.0 or higher
  • Git: For version control

Local Development

  1. Clone the repository

    git clone https://github.com/RedjiJB/drone-Zoe.git
    cd drone-Zoe
  2. Navigate to the app directory

    cd apps/www
  3. Install dependencies

    npm install
  4. Start development server

    npm run dev
  5. Open your browser Navigate to http://localhost:3002

Available Scripts

# Development
npm run dev          # Start development server on port 3002
npm run build        # Build for production
npm run start        # Start production server
npm run lint         # Run ESLint

# Deployment (manual)
npm run predeploy    # Build and prepare for deployment
npm run deploy       # Deploy to GitHub Pages (manual)

# Registry (components)
npm run registry:build  # Build component registry

๐Ÿ“ฆ Deployment

Automatic Deployment

Every push to the main branch automatically triggers deployment via GitHub Actions:

  1. Build Process: Next.js static export
  2. Optimization: Asset optimization and minification
  3. Deploy: Upload to GitHub Pages
  4. Domain: Serve on dronezoe.net

Manual Deployment

# Trigger deployment manually
gh workflow run "Deploy Drone Zoe to GitHub Pages"

# Or deploy locally (requires setup)
npm run deploy

Monitoring Deployment


๐Ÿข Platform Features

๐Ÿ–ฅ๏ธ Enhanced Dashboard Ecosystem

  • Role-Based Architecture: Specialized interfaces for Organization Admin, Member, Cooperative Manager, and System Admin
  • โœ… Comprehensive Sidebar Navigation: 8-9 organized sections per dashboard with smooth transitions and page memory
  • Unified Naming Convention: Consistent {role}-dashboard and {project}-site patterns across all services
  • Advanced Navigation System: JavaScript page switching, CSS animations, localStorage persistence, theme toggle integration
  • Multi-Platform Design: Next.js and Node.js implementations with shadcn/ui components
  • ๐ŸŒ™ Complete Theme System: Dark/light mode toggle with smooth transitions and preference persistence
  • Enhanced User Experience: Comprehensive sidebar structures with Quick Access, role-specific sections, and support areas
  • Professional Interface: Modern design system with consistent branding and Haiti Drone Cooperative identity
  • Service Coordination: Unified launcher with automated port management and service discovery
  • Development Integration: Hot reload, debugging tools, and comprehensive development environment

๐ŸŽจ Custom Drone Designer

  • AI-Powered Configuration: Intelligent component recommendations
  • Real-Time 3D Visualization: Interactive design studio
  • Mission-Specific Optimization: Tailored for unique requirements
  • Local Manufacturing Integration: 95% 3D-printable components
  • Multi-Language Support: Available in Haitian Creole
  • Accessibility Features: Voice guidance and SMS ordering

๐Ÿ’ฐ Investment Platform

  • Micro-Investments: Start from 131 HTG ($1)
  • Equipment Shares: Own parts of specific drones
  • Service Hours: Purchase individual service hours
  • Portfolio Tracking: Monitor investment performance
  • Democratic Voting: Participate in cooperative decisions

Hardware & Platform Solutions

  • 4-Tier Drone Matrix: Micro (50-250g) to Heavy-Lift (10-25kg) platforms
  • 13+ Platform Types: Complete coverage from surveillance to cargo transport
  • Open Source Sensor Modules: 8 modular packages with 3D printable housings
  • Flightory Partnership: Professional fixed-wing aircraft with 94-98% cost savings
  • Complete BOM System: Detailed bill of materials with USD and HTG pricing
  • Local Manufacturing: 75-85% local content with technological independence

Service Categories

  • Agricultural Services: Precision farming and crop monitoring
  • Infrastructure Inspection: Roads, bridges, utilities
  • Emergency Response: Search and rescue, disaster assessment
  • Media & Documentation: Aerial photography and videography
  • Environmental Monitoring: Conservation and research
  • Security & Surveillance: Monitoring and safety

Technology Integration

  • Blockchain Tracking: Transparent ownership records
  • Smart Contracts: Automated revenue distribution
  • Real-time Monitoring: Equipment status and utilization
  • Geographic Coverage: Service area mapping
  • Performance Analytics: ROI and impact metrics

๐ŸŽจ Design System

Visual Identity

  • Color Palette: Modern, professional with Haiti-inspired accents
  • Typography: Clean, readable with Geist font family
  • Animations: Smooth, purposeful motion design
  • Icons: Lucide icon system with custom drone imagery
  • Layout: Grid-based responsive design

Component Library

  • Hero Sections: Multiple variants for different pages
  • Interactive Elements: Buttons, forms, navigation
  • Data Visualization: Charts, metrics, dashboards
  • Motion Components: Animations and transitions
  • Responsive Design: Mobile-first approach

Accessibility

  • WCAG Compliance: Following accessibility standards
  • Keyboard Navigation: Full keyboard support
  • Screen Readers: Semantic HTML and ARIA labels
  • Color Contrast: Meets AA accessibility standards
  • Performance: Optimized for all devices

๐ŸŒ Community & Contribution

Development Philosophy

  • Cooperative Values: Democratic, inclusive, transparent
  • Open Source: Community-driven development
  • Haiti-Focused: Culturally appropriate and locally relevant
  • Sustainable: Long-term viability and impact
  • Innovation: Cutting-edge technology for social good

Contributing

We welcome contributions from developers, designers, and community members:

  1. Fork the repository
  2. Create a feature branch: git checkout -b feature/amazing-feature
  3. Make your changes: Follow our coding standards
  4. Test thoroughly: Ensure everything works
  5. Submit a pull request: Describe your changes

Code Standards

  • TypeScript: Strongly typed code
  • ESLint: Follow configuration rules
  • Prettier: Consistent code formatting
  • Components: Reusable, well-documented
  • Testing: Write tests for new features

๐Ÿ“Š Project Status

Current Phase: Enhanced Dashboard System & Platform Operations โœ…

  • Website Architecture: Complete and live
  • Content System: All pages implemented
  • Component Library: Advanced UI components with shadcn/ui
  • Production Deployment: Live at dronezoe.net
  • CI/CD Pipeline: Automated deployment
  • Performance Optimization: Static site optimization
  • Enhanced Dashboard System: 6-service integrated platform with comprehensive sidebar navigation
  • Unified Service Architecture: Consistent naming conventions and port management
  • Advanced Navigation: JavaScript page switching, CSS animations, and theme integration
  • Role-Based Interfaces: Specialized dashboards for different user types with 8-9 organized sections each

Next Phase: Platform Development ๐Ÿšง

  • User Authentication: Member registration and login
  • Investment System: Real investment processing
  • Payment Integration: HTG, USD, cryptocurrency
  • Blockchain Integration: Ownership tracking
  • Real-time Data: Live equipment monitoring
  • API Development: Backend services

Future Phases: Expansion ๐Ÿ”ฎ

  • Mobile Application: iOS and Android apps
  • International Expansion: Other Caribbean markets
  • Advanced Analytics: AI-powered insights
  • Partnership Platform: Vendor and service integrations
  • Educational Program: Training and certification

๐Ÿ“ˆ Performance & Analytics

Site Performance

  • Build Time: ~2-3 minutes
  • Page Load: <2 seconds globally
  • Lighthouse Score: 95+ performance
  • Bundle Size: Optimized for speed
  • CDN Distribution: Global availability

Development Metrics

  • Code Quality: TypeScript, ESLint, Prettier
  • Component Coverage: 95% reusable components
  • Responsive Design: 100% mobile compatible
  • Accessibility: WCAG AA compliant
  • SEO Optimized: Meta tags, sitemap, robots.txt

๐Ÿ”— Important Links

Live Platform

Documentation

Social & Community


๐Ÿ›ก๏ธ Security & Privacy

Data Protection

  • HTTPS: Enforced SSL/TLS encryption
  • Privacy Policy: Transparent data handling
  • No Personal Data: Currently static site only
  • Future Security: Planned security audits for platform features

Development Security

  • Dependencies: Regular security updates
  • Code Review: All changes reviewed
  • Static Analysis: Automated security scanning
  • Access Control: Repository permissions

๐Ÿ“„ License

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

Open Source Commitment

  • Free to Use: Open source for community benefit
  • Collaborative: Encouraging community contributions
  • Transparent: All development in the open
  • Educational: Learning resource for others

๐Ÿ™ Acknowledgments

Technology Partners

  • Next.js Team: Amazing React framework
  • Vercel: Development and hosting platform
  • GitHub: Repository hosting and CI/CD
  • Tailwind CSS: Utility-first CSS framework

Community

  • Contributors: All developers and designers who contribute
  • Beta Testers: Community members testing the platform
  • Advisors: Technical and business guidance
  • Haiti Tech Community: Local technology ecosystem

๐Ÿ“ž Support & Contact

Getting Help

  • Documentation: Check DEPLOYMENT.md and other docs
  • GitHub Issues: Report bugs and request features
  • Discussions: Community discussions and questions
  • Email Support: For urgent issues and partnerships

Business Inquiries


Drone Zoe - Democratizing Drone Technology Through Cooperation

๐ŸŒ Visit Website โ€ข ๐Ÿ“– Documentation โ€ข ๐Ÿš€ Deploy โ€ข ๐Ÿค Contribute

Made with โค๏ธ for the Haiti tech community and cooperative movement

About

No description, website, or topics provided.

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published