Joakim
bb5ea6f873
## Library Code Cleanup (~1,200+ lines removed) - Remove legacy markdown system (markdown.js, previewer.js) - Delete unused EditContext code from ui/editor.js (~400 lines) - Remove version history UI components from form-renderer.js (~180 lines) - Clean unused CSS styles from insertr.css (~120 lines) - Update package.json dependencies (remove marked, turndown) ## Documentation Updates - README.md: Update from markdown to HTML-first approach - AGENTS.md: Add current architecture guidance and HTML-first principles - TODO.md: Complete rewrite with realistic roadmap and current status - demos/README.md: Update for development demo server usage ## System Reality Alignment - All documentation now reflects current working system - Removed aspirational features in favor of actual capabilities - Clear separation between development and production workflows - Accurate description of style-aware editor with HTML preservation ## Code Cleanup Benefits - Simplified codebase focused on HTML-first approach - Removed markdown conversion complexity - Cleaner build process without unused dependencies - Better alignment between frontend capabilities and documentation Ready for Phase 3a server updates with clean foundation.
Demo Sites Collection
This directory contains demo sites for testing and showcasing Insertr CMS functionality across different layouts, CSS frameworks, and content types.
Available Demo Sites
default/ - Basic Demo Site
- Simple HTML with explicit
class="insertr"markings - Demonstrates basic text and link editing
- Vanilla CSS styling
simple/ - Minimal Example
- Single page with minimal styling
- Shows container expansion (
.insertron parent elements) - Good starting point for new implementations
dan-eden-portfolio/ - Real-World Portfolio
- Clean personal portfolio with modern styling
- Uses automatic element discovery (no manual
.insertrclasses) - Demonstrates style-aware editing with complex CSS
devigo-web/ - Multi-Page Site
- Multiple HTML files with navigation
- Various content types (headings, paragraphs, buttons, links)
- Tests cross-page content management
Demo Server Usage
Development Testing
# Start demo server with all sites
just dev
# Access sites at:
# http://localhost:8080/sites/default/
# http://localhost:8080/sites/simple/
# http://localhost:8080/sites/dan-eden-portfolio/
# http://localhost:8080/sites/devigo-web/
Configuration
Each demo site is configured in insertr.yaml:
server:
sites:
- site_id: "default"
source_path: "./demos/default"
path: "./demos/default_enhanced"
auto_enhance: true
discovery:
enabled: false # Uses explicit .insertr markings
- site_id: "dan-eden-portfolio"
source_path: "./demos/dan-eden-portfolio"
path: "./demos/dan-eden-portfolio_enhanced"
auto_enhance: true
discovery:
enabled: true # Auto-discovers editable elements
Testing Features
- Style-Aware Editing: Each site tests different CSS frameworks and styling approaches
- Element Discovery: Compare manual
.insertrvs automatic discovery modes - Content Types: Test text, rich content, links, and multi-property elements
- Authentication: Mock authentication for easy testing without setup
Adding New Demo Sites
- Create new directory in
demos/ - Add HTML files and assets
- Configure in
insertr.yamlunderserver.sites - Run
just devto test