LocalShare is a modern local network file sharing tool that allows you to quickly share files between devices on the same network. No complex configuration required - just drag and drop to share, and other devices can access and download files through their browsers.

• 🌐 Zero-configuration sharing: Drag and drop files to share on local network
• 🔒 PIN code protection: 4-digit password protection for secure access
• 📱 Cross-device access: Any device can access through browser
• 🎨 Modern interface: Beautiful desktop application interface based on Ant Design
• 🖥️ Cross-platform support: Windows, macOS, Linux full platform support
• 📁 Folder support: Share entire folders with directory structure
• 🚀 Real-time access: Files remain in original location, no copying or uploading required
• 📤 Upload functionality: Optional web-based file upload with configurable storage path

• React 18 - User interface framework
• TypeScript - Type-safe JavaScript
• Ant Design - Enterprise-level UI component library
• Vite - Modern frontend build tool

• Electron - Cross-platform desktop application framework
• Node.js - JavaScript runtime
• HTTP Server - Built-in file server
• IPC Communication - Main process and renderer process communication

• electron-builder - Application packaging tool
• TypeScript - Type checking and compilation
• ESLint - Code quality checking

localshare/
├── src/                          # React frontend source code
│   ├── components/              # React components
│   │   ├── FileDropZone.tsx    # File drag and drop component
│   │   ├── FileList.tsx        # File list component
│   │   └── WindowsControls.tsx # Windows window controls
│   ├── types.ts                # TypeScript type definitions
│   ├── App.tsx                 # Main application component
│   ├── App.css                 # Application styles
│   └── main.tsx               # React entry file
├── electron/                   # Electron main process
│   ├── modules/               # Feature modules
│   │   ├── httpServer.cjs     # HTTP server module
│   │   ├── pageRenderer.cjs   # Page rendering module
│   │   ├── windowManager.cjs  # Window management module
│   │   └── ipcHandlers.cjs    # IPC communication handling
│   ├── main.cjs              # Electron main entry
│   ├── preload.cjs           # Preload script
│   └── fileUtils.cjs         # File utility functions
├── scripts/                  # Build scripts
│   └── dev.js               # Development environment startup script
├── dist/                    # Build output directory
├── package.json            # Project configuration
├── tsconfig.json          # TypeScript configuration
├── tsconfig.node.json     # Node.js TypeScript configuration
├── vite.config.ts         # Vite build configuration
└── README.md             # Project documentation

• Node.js 16.0+
• npm or yarn

npm install

npm run dev

npm run build

npm run electron:build

1. Start Application: Double-click to run LocalShare
2. Add Files:
   • Drag and drop files/folders to application window
   • Click "Select Files" or "Select Folders" buttons
3. Set Security: Click "Enable PIN Protection" to generate 4-digit password
4. Share Access: Share the displayed local network address with other devices
5. Access Files: Other devices enter address and PIN code in browser

• File Management: Add and manage files to share
• Server: View server status and security settings
• About: Application information and usage instructions
• Settings: Application configuration and quick operations

• File and folder drag-and-drop sharing
• Native file picker support
• Local network HTTP server
• Beautiful web file browsing interface
• Online directory structure browsing
• Direct file download
• Custom 404 error page
• File upload functionality with configurable storage path

• 4-digit PIN code protection
• Session management (Cookie)
• Dynamic PIN code generation
• One-click enable/disable protection

• Modern desktop application interface
• Sidebar navigation design
• Ant Design component integration
• Scrollable file list (height limit 300px)
• File operation buttons (copy link, delete)
• Real-time server status display
• Message prompt feedback

• Windows window control adaptation
• macOS title bar adaptation
• Platform-specific styles
• Window size limits (800x600 ~ 1400x1000)

• File fingerprint deduplication mechanism
• IPC inter-process communication
• Modular code architecture
• TypeScript type safety
• Responsive layout design

• Configurable upload functionality switch
• Customizable upload storage path
• Multiple file upload support
• File size limits (100MB per file)
• Automatic directory creation
• File name conflict resolution

• QR Code Sharing

  • Generate QR codes for access addresses
  • Quick mobile device access via scanning
  • Easy mobile device connection

• System Tray Integration

  • Minimize to system tray
  • Tray menu quick operations
  • Background running mode

• User Experience Enhancement

  • Dark theme mode
  • Multi-language support (English/Chinese)
  • Custom theme colors
  • Access history records

• File Management Optimization

  • Batch file operations
  • File search functionality
  • Group display by type
  • File size sorting

• Network Features

  • Automatic local network device discovery
  • Device connection status display
  • Bandwidth usage limits
  • IPv6 network support

• Security Enhancement

  • Access log recording
  • Temporary access links
  • Guest mode
  • File access permissions

• Advanced Features

  • Bidirectional file transfer (upload)
  • Resume broken downloads
  • File compression transmission
  • Cloud storage synchronization

• System Integration

  • Auto-start on boot
  • Right-click menu integration
  • Desktop shortcuts
  • REST API interface

Welcome to submit Issues and Pull Requests!

• Use TypeScript for coding
• Follow ESLint code standards
• Use React Hooks for components
• Use CSS Modules or styled-components for styling

• feat: New feature
• fix: Bug fix
• docs: Documentation update
• style: Code format adjustment
• refactor: Code refactoring
• test: Testing related
• chore: Build/tool related

MIT License - See LICENSE file for details

• Electron Official Documentation
• React Official Documentation
• Ant Design Component Library
• Vite Build Tool

If you have questions or suggestions, feel free to contact us through:

• Submit GitHub Issue