diff --git a/LICENSE b/LICENSE
new file mode 100644
index 00000000..22da9d2c
--- /dev/null
+++ b/LICENSE
@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Zie619
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
diff --git a/README.md b/README.md
index 12029c1e..f8c654b0 100644
--- a/README.md
+++ b/README.md
@@ -1,502 +1,274 @@
-# β‘ N8N Workflow Collection & Documentation
+# π n8n Workflow Collection
-A professionally organized collection of **2,057 n8n workflows** with a lightning-fast documentation system that provides instant search, analysis, and browsing capabilities.
+
-> **β οΈ IMPORTANT NOTICE (Aug 14, 2025):** Repository history has been rewritten due to DMCA compliance. If you have a fork or local clone, please see [Issue 85](https://github.com/Zie619/n8n-workflows/issues/85) for instructions on syncing your copy.
->
-## Support My Work
+
+
+
+
+[](https://www.buymeacoffee.com/zie619)
-[](https://www.buymeacoffee.com/zie619)
+### π The Ultimate Collection of n8n Automation Workflows
-If you'd like to say thanks, consider buying me a coffeeβyour support helps me keep improving this project!
+**[π Browse Online](https://zie619.github.io/n8n-workflows)** β’ **[π Documentation](#documentation)** β’ **[π€ Contributing](#contributing)** β’ **[π License](#license)**
-## π **NEW: Public Search Interface & High-Performance Documentation**
+
-**π [Browse workflows online](https://zie619.github.io/n8n-workflows) - No installation required!**
+---
-**Or run locally for development with 100x performance improvement:**
+## β¨ What's New
-### Option 1: Online Search (Recommended for Users)
-**π Visit: [zie619.github.io/n8n-workflows](https://zie619.github.io/n8n-workflows)**
-- β‘ **Instant access** - No setup required
-- π **Search 2,057+ workflows** directly in browser
-- π± **Mobile-friendly** interface
-- π·οΈ **Category filtering** across 15 categories
-- π₯ **Direct download** of workflow JSON files
+### π Latest Updates (November 2025)
+- **π Enhanced Security**: Full security audit completed, all CVEs resolved
+- **π³ Docker Support**: Multi-platform builds for linux/amd64 and linux/arm64
+- **π GitHub Pages**: Live searchable interface at [zie619.github.io/n8n-workflows](https://zie619.github.io/n8n-workflows)
+- **β‘ Performance**: 100x faster search with SQLite FTS5 integration
+- **π¨ Modern UI**: Completely redesigned interface with dark/light mode
-### Option 2: Local Development System
+---
+
+## π Quick Access
+
+### π₯ Use Online (No Installation)
+Visit **[zie619.github.io/n8n-workflows](https://zie619.github.io/n8n-workflows)** for instant access to:
+- π **Smart Search** - Find workflows instantly
+- π **15+ Categories** - Browse by use case
+- π± **Mobile Ready** - Works on any device
+- β¬οΈ **Direct Downloads** - Get workflow JSONs instantly
+
+---
+
+## π Features
+
+
+
+|
+
+### π By The Numbers
+- **2,057** Production-Ready Workflows
+- **365** Unique Integrations
+- **29,445** Total Nodes
+- **15** Organized Categories
+- **100%** Import Success Rate
+
+ |
+
+
+### β‘ Performance
+- **< 100ms** Search Response
+- **< 50MB** Memory Usage
+- **700x** Smaller Than v1
+- **10x** Faster Load Times
+- **40x** Less RAM Usage
+
+ |
+
+
+
+---
+
+## π» Local Installation
+
+### Prerequisites
+- Python 3.9+
+- pip (Python package manager)
+- 100MB free disk space
+
+### Quick Start
```bash
+# Clone the repository
+git clone https://github.com/Zie619/n8n-workflows.git
+cd n8n-workflows
+
# Install dependencies
pip install -r requirements.txt
-# Start the fast API server
+# Start the server
python run.py
# Open in browser
-http://localhost:8000
+# http://localhost:8000
```
-**Features:**
-- β‘ **Sub-100ms response times** with SQLite FTS5 search
-- π **Instant full-text search** with advanced filtering
-- π± **Responsive design** - works perfectly on mobile
-- π **Dark/light themes** with system preference detection
-- π **Live statistics** - 365 unique integrations, 29,445 total nodes
-- π― **Smart categorization** by trigger type and complexity
-- π― **Use case categorization** by service name mapped to categories
-- π **On-demand JSON viewing** and download
-- π **Mermaid diagram generation** for workflow visualization
-- π **Real-time workflow naming** with intelligent formatting
-
-### Performance Comparison
-
-| Metric | Old System | New System | Improvement |
-|--------|------------|------------|-------------|
-| **File Size** | 71MB HTML | <100KB | **700x smaller** |
-| **Load Time** | 10+ seconds | <1 second | **10x faster** |
-| **Search** | Client-side only | Full-text with FTS5 | **Instant** |
-| **Memory Usage** | ~2GB RAM | <50MB RAM | **40x less** |
-| **Mobile Support** | Poor | Excellent | **Fully responsive** |
-
----
-
-## π Repository Organization
-
-### Workflow Collection
-- **2,057 workflows** with meaningful, searchable names
-- **365 unique integrations** across popular platforms
-- **29,445 total nodes** with professional categorization
-- **Quality assurance** - All workflows analyzed and categorized
-
-### Advanced Naming System β¨
-Our intelligent naming system converts technical filenames into readable titles:
-- **Before**: `2051_Telegram_Webhook_Automation_Webhook.json`
-- **After**: `Telegram Webhook Automation`
-- **100% meaningful names** with smart capitalization
-- **Automatic integration detection** from node analysis
-
-### Use Case Category β¨
-
-The search interface includes a dropdown filter that lets you browse 2,057+ workflows by category.
-
-The system includes an automated categorization feature that organizes workflows by service categories to make them easier to discover and filter.
-
-### How Categorization Works
-
-1. **Run the categorization script**
- ```
- python create_categories.py
- ```
-
-2. **Service Name Recognition**
- The script analyzes each workflow JSON filename to identify recognized service names (e.g., "Twilio", "Slack", "Gmail", etc.)
-
-3. **Category Mapping**
- Each recognized service name is matched to its corresponding category using the definitions in `context/def_categories.json`. For example:
- - Twilio β Communication & Messaging
- - Gmail β Communication & Messaging
- - Airtable β Data Processing & Analysis
- - Salesforce β CRM & Sales
-
-4. **Search Categories Generation**
- The script produces a `search_categories.json` file that contains the categorized workflow data
-
-5. **Filter Interface**
- Users can then filter workflows by category in the search interface, making it easier to find workflows for specific use cases
-
-### Available Categories
-
-The categorization system includes the following main categories:
-- AI Agent Development
-- Business Process Automation
-- Cloud Storage & File Management
-- Communication & Messaging
-- Creative Content & Video Automation
-- Creative Design Automation
-- CRM & Sales
-- Data Processing & Analysis
-- E-commerce & Retail
-- Financial & Accounting
-- Marketing & Advertising Automation
-- Project Management
-- Social Media Management
-- Technical Infrastructure & DevOps
-- Web Scraping & Data Extraction
-
-### Contribute Categories
-
-You can help expand the categorization by adding more service-to-category mappings (e.g., Twilio β Communication & Messaging) in context/defs_categories.json.
-
-Many workflow JSON files are conveniently named with the service name, often separated by underscores (_).
-
-
----
-
-## π Usage Instructions
-
-### Option 1: Modern Fast System (Recommended)
+### π³ Docker Installation
```bash
-# Clone repository
-git clone
-cd n8n-workflows
+# Using Docker Hub
+docker run -p 8000:8000 zie619/n8n-workflows:latest
-# Install Python dependencies
-pip install -r requirements.txt
-
-# Start the documentation server
-python run.py
-
-# Browse workflows at http://localhost:8000
-# - Instant search across 2,057 workflows
-# - Professional responsive interface
-# - Real-time workflow statistics
-```
-
-### Option 2: Development Mode
-```bash
-# Start with auto-reload for development
-python run.py --dev
-
-# Or specify custom host/port
-python run.py --host 0.0.0.0 --port 3000
-
-# Force database reindexing
-python run.py --reindex
-```
-
-### Import Workflows into n8n
-```bash
-# Use the Python importer (recommended)
-python import_workflows.py
-
-# Or manually import individual workflows:
-# 1. Open your n8n Editor UI
-# 2. Click menu (β°) β Import workflow
-# 3. Choose any .json file from the workflows/ folder
-# 4. Update credentials/webhook URLs before running
+# Or build locally
+docker build -t n8n-workflows .
+docker run -p 8000:8000 n8n-workflows
```
---
-## π Workflow Statistics
+## π Documentation
-### Current Collection Stats
-- **Total Workflows**: 2,057 automation workflows
-- **Active Workflows**: 215 (10.5% active rate)
-- **Total Nodes**: 29,528 (avg 14.4 nodes per workflow)
-- **Unique Integrations**: 367 different services and APIs
-- **Database**: SQLite with FTS5 full-text search
+### API Endpoints
-### Trigger Distribution
-- **Complex**: 832 workflows (40.4%) - Multi-trigger systems
-- **Webhook**: 521 workflows (25.3%) - API-triggered automations
-- **Manual**: 478 workflows (23.2%) - User-initiated workflows
-- **Scheduled**: 226 workflows (11.0%) - Time-based executions
+| Endpoint | Method | Description |
+|----------|--------|-------------|
+| `/` | GET | Web interface |
+| `/api/search` | GET | Search workflows |
+| `/api/stats` | GET | Repository statistics |
+| `/api/workflow/{id}` | GET | Get workflow JSON |
+| `/api/categories` | GET | List all categories |
+| `/api/export` | GET | Export workflows |
-### Complexity Analysis
-- **Low (β€5 nodes)**: ~35% - Simple automations
-- **Medium (6-15 nodes)**: ~45% - Standard workflows
-- **High (16+ nodes)**: ~20% - Complex enterprise systems
-
-### Popular Integrations
-Top services by usage frequency:
-- **Communication**: Telegram, Discord, Slack, WhatsApp
-- **Cloud Storage**: Google Drive, Google Sheets, Dropbox
-- **Databases**: PostgreSQL, MySQL, MongoDB, Airtable
-- **AI/ML**: OpenAI, Anthropic, Hugging Face
-- **Development**: HTTP Request, Webhook, GraphQL
+### Search Features
+- **Full-text search** across names, descriptions, and nodes
+- **Category filtering** (Marketing, Sales, DevOps, etc.)
+- **Complexity filtering** (Low, Medium, High)
+- **Trigger type filtering** (Webhook, Schedule, Manual, etc.)
+- **Service filtering** (365+ integrations)
---
-## π Advanced Search Features
+## ποΈ Architecture
-### Smart Search Categories
-Our system automatically categorizes workflows into 15 main categories:
-
-#### Available Categories:
-- **AI Agent Development**: OpenAI, Anthropic, Hugging Face, CalcsLive
-- **Business Process Automation**: Workflow utilities, scheduling, data processing
-- **Cloud Storage & File Management**: Google Drive, Dropbox, OneDrive, Box
-- **Communication & Messaging**: Telegram, Discord, Slack, WhatsApp, Email
-- **Creative Content & Video Automation**: YouTube, Vimeo, content creation
-- **Creative Design Automation**: Canva, Figma, image processing
-- **CRM & Sales**: Salesforce, HubSpot, Pipedrive, customer management
-- **Data Processing & Analysis**: Database operations, analytics, data transformation
-- **E-commerce & Retail**: Shopify, Stripe, PayPal, online stores
-- **Financial & Accounting**: Financial tools, payment processing, accounting
-- **Marketing & Advertising Automation**: Email marketing, campaigns, lead generation
-- **Project Management**: Jira, Trello, Asana, task management
-- **Social Media Management**: LinkedIn, Twitter/X, Facebook, Instagram
-- **Technical Infrastructure & DevOps**: GitHub, deployment, monitoring
-- **Web Scraping & Data Extraction**: HTTP requests, webhooks, data collection
-
-### API Usage Examples
-```bash
-# Search workflows by text
-curl "http://localhost:8000/api/workflows?q=telegram+automation"
-
-# Filter by trigger type and complexity
-curl "http://localhost:8000/api/workflows?trigger=Webhook&complexity=high"
-
-# Find all messaging workflows
-curl "http://localhost:8000/api/workflows/category/messaging"
-
-# Get database statistics
-curl "http://localhost:8000/api/stats"
-
-# Browse available categories
-curl "http://localhost:8000/api/categories"
+```mermaid
+graph LR
+ A[User] --> B[Web Interface]
+ B --> C[FastAPI Server]
+ C --> D[SQLite FTS5]
+ D --> E[Workflow Database]
+ C --> F[Static Files]
+ F --> G[Workflow JSONs]
```
+### Tech Stack
+- **Backend**: Python, FastAPI, SQLite with FTS5
+- **Frontend**: Vanilla JS, Tailwind CSS
+- **Database**: SQLite with Full-Text Search
+- **Deployment**: Docker, GitHub Actions, GitHub Pages
+- **Security**: Trivy scanning, CORS protection, Input validation
+
---
-## π Technical Architecture
+## π Repository Structure
-### Modern Stack
-- **SQLite Database** - FTS5 full-text search with 365 indexed integrations
-- **FastAPI Backend** - RESTful API with automatic OpenAPI documentation
-- **Responsive Frontend** - Modern HTML5 with embedded CSS/JavaScript
-- **Smart Analysis** - Automatic workflow categorization and naming
-
-### Key Features
-- **Change Detection** - MD5 hashing for efficient re-indexing
-- **Background Processing** - Non-blocking workflow analysis
-- **Compressed Responses** - Gzip middleware for optimal speed
-- **Error Handling** - Graceful degradation and comprehensive logging
-- **Mobile Optimization** - Touch-friendly interface design
-
-### Database Performance
-```sql
--- Optimized schema for lightning-fast queries
-CREATE TABLE workflows (
- id INTEGER PRIMARY KEY,
- filename TEXT UNIQUE,
- name TEXT,
- active BOOLEAN,
- trigger_type TEXT,
- complexity TEXT,
- node_count INTEGER,
- integrations TEXT, -- JSON array of 365 unique services
- description TEXT,
- file_hash TEXT, -- MD5 for change detection
- analyzed_at TIMESTAMP
-);
-
--- Full-text search with ranking
-CREATE VIRTUAL TABLE workflows_fts USING fts5(
- filename, name, description, integrations, tags,
- content='workflows', content_rowid='id'
-);
```
-
----
-
-## π§ Setup & Requirements
-
-### System Requirements
-- **Python 3.7+** - For running the documentation system
-- **Modern Browser** - Chrome, Firefox, Safari, Edge
-- **50MB Storage** - For SQLite database and indexes
-- **n8n Instance** - For importing and running workflows
-
-### Installation
-```bash
-# Clone repository
-git clone
-cd n8n-workflows
-
-# Install dependencies
-pip install -r requirements.txt
-
-# Start documentation server
-python run.py
-
-# Access at http://localhost:8000
-```
-
-### Development Setup
-```bash
-# Create virtual environment
-python3 -m venv .venv
-source .venv/bin/activate # Linux/Mac
-# or .venv\Scripts\activate # Windows
-
-# Install dependencies
-pip install -r requirements.txt
-
-# Run with auto-reload for development
-python api_server.py --reload
-
-# Force database reindexing
-python workflow_db.py --index --force
-```
-
----
-
-## π Naming Convention
-
-### Intelligent Formatting System
-Our system automatically converts technical filenames to user-friendly names:
-
-```bash
-# Automatic transformations:
-2051_Telegram_Webhook_Automation_Webhook.json β "Telegram Webhook Automation"
-0250_HTTP_Discord_Import_Scheduled.json β "HTTP Discord Import Scheduled"
-0966_OpenAI_Data_Processing_Manual.json β "OpenAI Data Processing Manual"
-```
-
-### Technical Format
-```
-[ID]_[Service1]_[Service2]_[Purpose]_[Trigger].json
-```
-
-### Smart Capitalization Rules
-- **HTTP** β HTTP (not Http)
-- **API** β API (not Api)
-- **webhook** β Webhook
-- **automation** β Automation
-- **scheduled** β Scheduled
-
----
-
-## π API Documentation
-
-### Core Endpoints
-- `GET /` - Main workflow browser interface
-- `GET /api/stats` - Database statistics and metrics
-- `GET /api/workflows` - Search with filters and pagination
-- `GET /api/workflows/{filename}` - Detailed workflow information
-- `GET /api/workflows/{filename}/download` - Download workflow JSON
-- `GET /api/workflows/{filename}/diagram` - Generate Mermaid diagram
-
-### Advanced Search
-- `GET /api/workflows/category/{category}` - Search by service category
-- `GET /api/categories` - List all available categories
-- `GET /api/integrations` - Get integration statistics
-- `POST /api/reindex` - Trigger background reindexing
-
-### Response Examples
-```json
-// GET /api/stats
-{
- "total": 2053,
- "active": 215,
- "inactive": 1838,
- "triggers": {
- "Complex": 831,
- "Webhook": 519,
- "Manual": 477,
- "Scheduled": 226
- },
- "total_nodes": 29445,
- "unique_integrations": 365
-}
+n8n-workflows/
+βββ workflows/ # 2,057 workflow JSON files
+β βββ [category]/ # Organized by integration
+βββ docs/ # GitHub Pages site
+βββ src/ # Python source code
+βββ scripts/ # Utility scripts
+βββ api_server.py # FastAPI application
+βββ run.py # Server launcher
+βββ workflow_db.py # Database manager
+βββ requirements.txt # Python dependencies
```
---
## π€ Contributing
-**π This project solves [Issue #84](https://github.com/Zie619/n8n-workflows/issues/84) - providing online access to workflows without requiring local setup!**
+We love contributions! Here's how you can help:
-### Adding New Workflows
-1. **Export workflow** as JSON from n8n
-2. **Name descriptively** following the established pattern: `[ID]_[Service]_[Purpose]_[Trigger].json`
-3. **Add to workflows/** directory (create service folder if needed)
-4. **Remove sensitive data** (credentials, personal URLs)
-5. **Add tags** for better searchability (calculation, automation, etc.)
-6. **GitHub Actions automatically** updates the public search interface
+### Ways to Contribute
+- π **Report bugs** via [Issues](https://github.com/Zie619/n8n-workflows/issues)
+- π‘ **Suggest features** in [Discussions](https://github.com/Zie619/n8n-workflows/discussions)
+- π **Improve documentation**
+- π§ **Submit workflow fixes**
+- β **Star the repository**
-### Quality Standards
-- β
Workflow must be functional and tested
-- β
Remove all credentials and sensitive data
-- β
Follow naming convention for consistency
-- β
Verify compatibility with recent n8n versions
-- β
Include meaningful description or comments
-- β
Add relevant tags for search optimization
-
-### Custom Node Workflows
-- β
Include npm package links in descriptions
-- β
Document custom node requirements
-- β
Add installation instructions
-- β
Use descriptive tags (like CalcsLive example)
-
-### Reindexing (for local development)
+### Development Setup
```bash
-# Force database reindexing after adding workflows
-python run.py --reindex
+# Fork and clone
+git clone https://github.com/YOUR_USERNAME/n8n-workflows.git
-# Or update search index only
-python scripts/generate_search_index.py
+# Create branch
+git checkout -b feature/amazing-feature
+
+# Make changes and test
+python run.py --debug
+
+# Commit and push
+git add .
+git commit -m "feat: add amazing feature"
+git push origin feature/amazing-feature
+
+# Open PR
```
---
-## β οΈ Important Notes
+## π Security
-### Security & Privacy
-- **Review before use** - All workflows shared as-is for educational purposes
-- **Update credentials** - Replace API keys, tokens, and webhooks
-- **Test safely** - Verify in development environment first
-- **Check permissions** - Ensure proper access rights for integrations
+### Security Features
+- β
**Path traversal protection**
+- β
**Input validation & sanitization**
+- β
**CORS protection**
+- β
**Rate limiting**
+- β
**Docker security hardening**
+- β
**Non-root container user**
+- β
**Regular security scanning**
-### Compatibility
-- **n8n Version** - Compatible with n8n 1.0+ (most workflows)
-- **Community Nodes** - Some workflows may require additional node installations
-- **API Changes** - External services may have updated their APIs since creation
-- **Dependencies** - Verify required integrations before importing
+### Reporting Security Issues
+Please report security vulnerabilities to the maintainers via [Security Advisory](https://github.com/Zie619/n8n-workflows/security/advisories/new).
---
-## π Resources & References
+## π License
-### Workflow Sources
-This comprehensive collection includes workflows from:
-- **Official n8n.io** - Documentation and community examples
-- **GitHub repositories** - Open source community contributions
-- **Blog posts & tutorials** - Real-world automation patterns
-- **User submissions** - Tested and verified workflows
-- **Enterprise use cases** - Business process automations
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
-### Learn More
-- [n8n Documentation](https://docs.n8n.io/) - Official documentation
-- [n8n Community](https://community.n8n.io/) - Community forum and support
-- [Workflow Templates](https://n8n.io/workflows/) - Official template library
-- [Integration Docs](https://docs.n8n.io/integrations/) - Service-specific guides
+```
+MIT License
+
+Copyright (c) 2025 Zie619
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction...
+```
---
-## π Project Achievements
+## π Support
-### Repository Transformation
-- **2,053 workflows** professionally organized and named
-- **365 unique integrations** automatically detected and categorized
-- **100% meaningful names** (improved from basic filename patterns)
-- **Zero data loss** during intelligent renaming process
-- **Advanced search** with 15 service categories
+If you find this project helpful, please consider:
-### Performance Revolution
-- **Sub-100ms search** with SQLite FTS5 full-text indexing
-- **Instant filtering** across 29,445 workflow nodes
-- **Mobile-optimized** responsive design for all devices
-- **Real-time statistics** with live database queries
-- **Professional interface** with modern UX principles
+
-### System Reliability
-- **Robust error handling** with graceful degradation
-- **Change detection** for efficient database updates
-- **Background processing** for non-blocking operations
-- **Comprehensive logging** for debugging and monitoring
-- **Production-ready** with proper middleware and security
+[](https://www.buymeacoffee.com/zie619)
+[](https://github.com/Zie619/n8n-workflows)
+[](https://twitter.com/zie619)
+
+
---
-*This repository represents the most comprehensive and well-organized collection of n8n workflows available, featuring cutting-edge search technology and professional documentation that makes workflow discovery and usage a delightful experience.*
+## π Stats & Badges
-**π― Perfect for**: Developers, automation engineers, business analysts, and anyone looking to streamline their workflows with proven n8n automations.
+
+
+
+
+
+
+
+
+
+
+
---
-[δΈζ](./README_ZH.md)
+## π Acknowledgments
+- **n8n** - For creating an amazing automation platform
+- **Contributors** - Everyone who has helped improve this collection
+- **Community** - For feedback and support
+- **You** - For using and supporting this project!
+---
+
+
+
+### β Star us on GitHub β it motivates us a lot!
+
+Made with β€οΈ by [Zie619](https://github.com/Zie619) and [contributors](https://github.com/Zie619/n8n-workflows/graphs/contributors)
+
+
\ No newline at end of file