Skip to content

Commit 56789e8

Browse files
e3dclaude
e3d
and
claude
committed
feat: Add GitHub Pages public search interface and enhanced documentation system
## 🌐 GitHub Pages Public Search Interface - Complete client-side search application solving Issue Zie619#84 - Responsive HTML/CSS/JavaScript with mobile optimization - Real-time search across 2,057+ workflows with instant results - Category filtering across 15 workflow categories - Dark/light theme support with system preference detection - Direct workflow JSON download functionality ## 🤖 GitHub Actions Automation - deploy-pages.yml: Automated deployment to GitHub Pages - update-readme.yml: Weekly automated README statistics updates - Comprehensive workflow indexing and category generation ## 🔍 Enhanced Search & Categorization - Static search index generation for GitHub Pages - Developer-chosen category prioritization system - CalcsLive custom node integration and categorization - Enhanced workflow database with better custom node detection - Fixed README corruption with live database statistics ## 📚 Documentation & Infrastructure - Comprehensive CHANGELOG.md with proper versioning - Enhanced README with accurate statistics and public interface links - Professional documentation solving repository infrastructure needs ## Technical Improvements - Fixed Unicode encoding issues in Python scripts - Enhanced CalcsLive detection with false positive prevention - Improved JSON description preservation and indexing - Mobile-optimized responsive design for all devices 🤖 Generated with Claude Code Co-Authored-By: Claude <noreply@anthropic.com>
1 parent ebcdcc4 commit 56789e8

File tree

16 files changed

+45113
-1406
lines changed

16 files changed

+45113
-1406
lines changed

‎.github/workflows/deploy-pages.yml‎

Lines changed: 75 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,75 @@
1+
name: Deploy GitHub Pages
2+
3+
on:
4+
push:
5+
branches: [ main ]
6+
paths:
7+
- 'workflows/**'
8+
- 'docs/**'
9+
- 'scripts/**'
10+
- 'workflow_db.py'
11+
- 'create_categories.py'
12+
workflow_dispatch: # Allow manual triggering
13+
14+
# Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages
15+
permissions:
16+
contents: read
17+
pages: write
18+
id-token: write
19+
20+
# Allow only one concurrent deployment, skipping runs queued between the run in-progress and latest queued.
21+
concurrency:
22+
group: "pages"
23+
cancel-in-progress: false
24+
25+
jobs:
26+
# Build job
27+
build:
28+
runs-on: ubuntu-latest
29+
steps:
30+
- name: Checkout
31+
uses: actions/checkout@v4
32+
33+
- name: Setup Python
34+
uses: actions/setup-python@v4
35+
with:
36+
python-version: '3.11'
37+
38+
- name: Install Python dependencies
39+
run: |
40+
python -m pip install --upgrade pip
41+
pip install -r requirements.txt
42+
43+
- name: Setup database and generate search index
44+
run: |
45+
# Create database directory
46+
mkdir -p database
47+
48+
# Index all workflows
49+
python workflow_db.py --index --force
50+
51+
# Generate categories
52+
python create_categories.py
53+
54+
# Generate static search index for GitHub Pages
55+
python scripts/generate_search_index.py
56+
57+
- name: Setup Pages
58+
uses: actions/configure-pages@v4
59+
60+
- name: Upload artifact
61+
uses: actions/upload-pages-artifact@v3
62+
with:
63+
path: './docs'
64+
65+
# Deployment job
66+
deploy:
67+
environment:
68+
name: github-pages
69+
url: ${{ steps.deployment.outputs.page_url }}
70+
runs-on: ubuntu-latest
71+
needs: build
72+
steps:
73+
- name: Deploy to GitHub Pages
74+
id: deployment
75+
uses: actions/deploy-pages@v4

‎.github/workflows/update-readme.yml‎

Lines changed: 61 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,61 @@
1+
name: Update README Stats
2+
3+
on:
4+
push:
5+
branches: [ main ]
6+
paths:
7+
- 'workflows/**'
8+
schedule:
9+
# Run weekly on Sunday at 00:00 UTC
10+
- cron: '0 0 * * 0'
11+
workflow_dispatch: # Allow manual triggering
12+
13+
jobs:
14+
update-stats:
15+
runs-on: ubuntu-latest
16+
steps:
17+
- name: Checkout
18+
uses: actions/checkout@v4
19+
with:
20+
token: ${{ secrets.GITHUB_TOKEN }}
21+
22+
- name: Setup Python
23+
uses: actions/setup-python@v4
24+
with:
25+
python-version: '3.11'
26+
27+
- name: Install Python dependencies
28+
run: |
29+
python -m pip install --upgrade pip
30+
pip install -r requirements.txt
31+
32+
- name: Generate workflow statistics
33+
run: |
34+
# Create database directory
35+
mkdir -p database
36+
37+
# Index all workflows to get latest stats
38+
python workflow_db.py --index --force
39+
40+
# Generate categories
41+
python create_categories.py
42+
43+
# Get stats and update README
44+
python scripts/update_readme_stats.py
45+
46+
- name: Commit changes
47+
run: |
48+
git config --local user.email "action@github.com"
49+
git config --local user.name "GitHub Action"
50+
git add README.md
51+
if git diff --staged --quiet; then
52+
echo "No changes to README.md"
53+
else
54+
git commit -m "📊 Update workflow statistics
55+
56+
- Updated workflow counts and statistics
57+
- Generated from latest workflow analysis
58+
59+
🤖 Automated update via GitHub Actions"
60+
git push
61+
fi

‎CHANGELOG.md‎

Lines changed: 77 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,77 @@
1+
# Changelog
2+
3+
All notable changes to this project will be documented in this file.
4+
5+
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
6+
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
7+
8+
## [Unreleased]
9+
10+
### Added
11+
- **GitHub Pages Public Search Interface** - Complete client-side search application accessible at https://zie619.github.io/n8n-workflows
12+
- Responsive HTML/CSS/JavaScript interface with mobile optimization
13+
- Real-time search across 2,057+ workflows with instant results
14+
- Category filtering across 15 workflow categories
15+
- Dark/light theme support with system preference detection
16+
- Direct workflow JSON download functionality
17+
- Professional n8n-themed styling and animations
18+
- **CalcsLive Custom Node Workflow** - Engineering calculations workflow showcasing CalcsLive custom node
19+
- Added `workflows/Calcslive/2058_Calcslive_Engineering_Calculations_Manual.json`
20+
- Comprehensive tags for searchability (calculation, engineering, custom-node, etc.)
21+
- Professional description with npm package reference
22+
- **GitHub Actions Automation**
23+
- `deploy-pages.yml` - Automated deployment to GitHub Pages on workflow changes
24+
- `update-readme.yml` - Weekly automated README statistics updates
25+
- **Search Index Generation System**
26+
- `scripts/generate_search_index.py` - Static search index generation for GitHub Pages
27+
- `scripts/update_readme_stats.py` - Automated README statistics synchronization
28+
- Support for both developer-chosen and integration-based categorization
29+
- **Enhanced Documentation System**
30+
- Real-time workflow statistics in README
31+
- Accurate category counts (updated from 12 to 15 categories)
32+
- GitHub Pages interface solving Issue #84
33+
34+
### Enhanced
35+
- **Workflow Database System** (`workflow_db.py`)
36+
- Enhanced CalcsLive custom node detection with pattern exclusions
37+
- Fixed false positive "Cal.com" detection from "CalcsLive" node names
38+
- Improved JSON description preservation and indexing
39+
- Better Unicode handling and error reporting
40+
- **Categorization System** (`create_categories.py`)
41+
- Added CalcsLive to "Data Processing & Analysis" category
42+
- Enhanced service name recognition patterns
43+
- Improved category mapping for custom nodes
44+
- **Search Index Prioritization**
45+
- Modified `generate_search_index.py` to respect developer-chosen categories
46+
- Added `load_existing_categories()` function to prioritize `create_categories.py` assignments
47+
- Maintains fairness by not favoring specific custom nodes
48+
49+
### Fixed
50+
- **Unicode Encoding Issues** - Resolved 'charmap' codec errors in Python scripts
51+
- **Category Assignment Logic** - Search index now properly respects developer category choices
52+
- **Statistics Accuracy** - README now reflects live database statistics instead of hardcoded numbers
53+
- **Documentation Inconsistencies** - Updated category documentation to match actual implementation
54+
55+
### Changed
56+
- **README.md** - Updated with current workflow statistics (2,057 workflows, 367 integrations)
57+
- **Repository Organization** - Enhanced with automated maintenance and public accessibility
58+
59+
## [Previous] - 2024-08-14
60+
61+
### Changed
62+
- Repository history rewritten due to DMCA compliance (Issue #85)
63+
- All existing workflows maintained with improved organization
64+
65+
---
66+
67+
## Contributing to the Changelog
68+
69+
When adding new changes:
70+
- Use **Added** for new features
71+
- Use **Changed** for changes in existing functionality
72+
- Use **Deprecated** for soon-to-be removed features
73+
- Use **Removed** for now removed features
74+
- Use **Fixed** for any bug fixes
75+
- Use **Security** for vulnerability fixes
76+
77+
Each entry should briefly explain the change and its impact on users or contributors.

0 commit comments

Comments
 (0)