Generated 2026-07-25 00:47

⚙️ BCBC Site Operations

Quick-reference commands, passwords, links, and workflows for managing the BCBC website. All commands and tools built during the 2026-07-24/25 session.

🖥️ Server

Custom Python dev + publish server — replaces python3 -m http.server

python3 server.py --port 8080

Restart after changes:

pkill -f "python3.*server.py" && python3 server.py --port 8080 &

File: /home/wj14franza/BCBC/02-PROJECTS/bcbc-main-site/server.py

Serves: public/ directory

🔌 API Endpoints

Method	Path	Purpose
GET	`/api/health`	Server health check
POST	`/api/publish`	Publish a page (Site Builder)
GET	`/api/source-files`	List 00-TICKLERS HTML files
POST	`/api/archive-source`	Move published file to _published/
GET	`/api/ticklers/visibility`	Read visibility settings
POST	`/api/ticklers/visibility`	Save visibility settings
GET	`/api/site-backup`	Download full site tar.gz
POST	`/api/site-restore`	Upload tar.gz to restore site

🔑 Passwords

Ticklers Admin: bcbc2026

Site Builder Publish Gate: bcbc2026

Both passwords are currently the same. To change, edit:

File: public/ticklers/index.html (line: const TICKLER_PASSWORD = 'bcbc2026') File: public/site-builder-tickler/index.html (line: const PUBLISH_PASSWORD = 'bcbc2026')

📁 Key Directories

Path	Purpose
`public/`	Served site root
`public/includes/`	Shared header.html, footer.html
`public/assets/`	CSS, SVG logo, images
`public/ticklers/files/`	Tickler file storage
`archive/loose-page-backups/`	Pre-publish backups
`archive/site-backups/`	Full site backups (tar.gz)
`/home/wj14franza/BCBC/00-TICKLERS/`	Source files for batch publish
`_published/`	Auto-archived published files

📋 Regenerate File Manifest

After adding new files to public/ticklers/files/, regenerate the manifest:

cd /home/wj14franza/BCBC/02-PROJECTS/bcbc-main-site
python3 public/ticklers/generate-manifest.py

📦 Publishing Workflows

Single Page (Site Builder)

Go to /site-builder-tickler/
Paste HTML or upload file → Strip & Clean
Choose theme, add header/footer → Generate
Preview, fill in publish form → click Publish
Enter password bcbc2026 → Confirm

Batch Publish (from 00-TICKLERS)

In Site Builder, expand Batch Publish
Click "Load Source Files"
Check files to publish, edit slugs/labels
Click "Publish Selected" → enter password
Files auto-archive to _published/ after success

Full Site Backup

curl -o bcbc-site-backup.tar.gz http://127.0.0.1:8080/api/site-backup

Full Site Restore

curl -X POST -F "sitefile=@backup.tar.gz" http://127.0.0.1:8080/api/site-restore

🧭 Navigation Structure

Nav groups used in header.html and footer.html:

About BCBC — Why BCBC Exists, About, Philosophy, How I Think
Projects & Work — Projects, Technician Tools, AI & Automation, plus all stubs
Reference & Tools — Command Reference, Tools, Downloads
Info — Resume

🔗 Quick Links

🏠 Home 🛠️ Site Builder 🔒 Ticklers Admin 📊 Projects ❓ Why BCBC Exists 📖 Command Reference 🛡️ Technician Tools 🌐 AI Security / Mesh 📚 Classes / Training ℹ️ About

🔧 Known Issues & Fixes

Nav group entity bug (FIXED): server.py now HTML-escapes group names so "Projects & Work" matches "Projects & Work" in nav includes.
Firefox snap won't die: Use sudo snap disable firefox to force stop, then sudo snap enable firefox to re-enable.
Publish 409 error: Page already exists — choose a different slug or delete the directory first.