WebFact Community Starter Template

The official open-source reference template module for ExtBit WebFact.

⚠️ Architecture Note: WebFact enforces a strict separation between content and presentation. This repository contains only the template module (HTML layout skeleton, Webpack exports, SCSS styling, and component generator logic). User content lives entirely in a separate repository (e.g., a private client repository holding Markdown content).

---

🏗️ Decoupled Architecture

WebFact site builds merge two distinct layers:

┌─────────────────────────┐      ┌──────────────────────────────┐
│  Client Content Repo    │      │  Template Module Repo        │
│  (Private Git)          │      │  (community-starter)         │
│                         │      │                              │
│  ├── index.md           │  ──► │  ├── index.html              │
│  ├── about.md           │      │  ├── index.js / exports.js   │
│  └── [config]           │      │  └── index.scss              │
└─────────────────────────┘      └──────────────────────────────┘
             │                                  │
             └──────────────┬───────────────────┘
                            ▼
               ExtBit WebFact Build Engine
                            │
                            ▼
                   Pre-Rendered Static Site

Note that [config] represents the site-config file .template-parameters/config.json in the client content repo.

1. Content Layer (Client Repository): Non-technical users edit standard Markdown files in their own repository without risk of breaking layout code or dependencies.
2. Template Layer (This Repository): Defines the compilation hooks, styles, and HTML layout. Advanced users and developers can fork or study this repository as a reference implementation for building custom WebFact templates.

---

📁 Template Module Structure

community-starter/
├── defs.svg         # SVG icon definitions & graphics sprite
├── exports.js       # Module entrypoint & asset export definitions
├── index.html       # Primary HTML layout template & injection tokens
├── index.js         # JavaScript generator & client-side component logic
├── index.scss       # SCSS stylesheets and design tokens
├── package.json     # Template metadata & build dependencies
└── README.md

---

🔧 Developer & Reference Guide

This repository serves as a reference implementation for engineers looking to construct or inspect ExtBit WebFact template packages.

Component Roles

• index.html: The pre-rendered DOM structure into which parsed Markdown text and metadata are injected during the build phase.
• exports.js: Exposes asset dependencies, template metadata, and style entrypoints to the core WebFact Webpack engine.
• index.js: Handles template-level dynamic behavior, component mounting, and bundle initialization.
• index.scss: Scoped styles and theme variables compiled into production CSS assets during build time.

---

☁️ Managed Services & Support (ExtBit LLC)

In production, you don't need to manually link or compile templates. ExtBit LLC provides productized infrastructure setup linking your private content repository directly to your selected WebFact template module:

• DIY / Standard: Turnkey configuration connecting your private GitHub content repo to WebFact templates, deploying directly to GCS or Cloudflare Pages.
• Monthly Maintenance: Cloud infrastructure oversight, bucket/DNS management, and up to 2 hours/month of custom template/content engineering.
• On-Demand Custom Engineering: Custom index.js generator development and bespoke layout modifications.

👉 Learn more at extbit.com/webfact
📧 Contact Engineering: support@extbit.com | biz@extbit.com

---

📄 License

This template module is licensed under the MIT License. Free to inspect, fork, and adapt for custom WebFact template development.