npm - ultimate-jekyll-manager - Versions diffs - 0.0.214 → 0.0.216 - Mend

ultimate-jekyll-manager 0.0.214 → 0.0.216

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (14) hide show

package/CLAUDE.md CHANGED Viewed

@@ -1015,6 +1015,95 @@ The `<html>` element has data attributes for JavaScript/CSS targeting:
 **Detection source:** `web-manager/src/modules/utilities.js`
+## Alternatives Collection (SEO Competitor Comparison Pages)
+UJ provides an `alternatives` collection for SEO landing pages that target users searching for competitors (e.g., "ExampleApp alternatives"). These pages are entirely frontmatter-driven and designed to convert visitors who are comparing products.
+### How It Works
+1. The `alternatives` collection is registered in `src/config/_config_default.yml` (UJM-controlled)
+2. Each alternative is a markdown file in the consuming project's `_alternatives/` directory
+3. The layout chain: `blueprint/alternatives/alternative` → `themes/classy/frontend/pages/alternatives/alternative`
+4. An index page at `/alternatives` lists all alternatives automatically
+5. **Shared content lives in the layout** — the theme layout provides default testimonials, stats, FAQs, CTA, and why_switch content so competitor pages only need competitor-specific data
+6. The layout frontmatter uses `{{ page.resolved.alternative.competitor.name }}` to dynamically insert the competitor name into shared content (e.g., FAQ questions, CTA headlines)
+### Creating an Alternative Page
+In the consuming project, create `src/_alternatives/competitor-name.md`. Only competitor-specific data is needed — shared sections are inherited from the layout:
+```yaml
+---
+layout: blueprint/alternatives/alternative
+sitemap:
+  include: true
+alternative:
+  competitor:
+    name: "Competitor Name"
+    description: "Brief description of the competitor (shown on /alternatives listing)"
+  comparison:
+    features:
+      - name: "Feature Name"
+        icon: "sparkles"
+        ours:
+          value: true  # or string like "Unlimited"
+        theirs:
+          value: false  # or string like "Limited"
+---
+```
+That's it! The layout automatically generates:
+- Hero with "Brand vs Competitor Name" headline
+- Why Switch section with default differentiator items
+- Testimonials, Stats, FAQs, and CTA with shared content
+- All text dynamically references the competitor name via `{{ page.resolved.alternative.competitor.name }}`
+**To override any inherited section**, define it in the competitor's frontmatter — `page.resolved` merge gives page-level values highest priority.
+### Available Sections
+All sections are **optional** — omit or leave empty to hide. Sections with `(shared)` have default content in the layout:
+| Section | Frontmatter Key | Description |
+|---------|----------------|-------------|
+| Hero | `alternative.hero` | Gradient animated hero with "Brand vs Competitor" headline (shared) |
+| Comparison | `alternative.comparison` | Side-by-side feature table — **must be defined per competitor** |
+| Why Switch | `alternative.why_switch` | Alternating image/text showcase blocks (shared) |
+| Video | `alternative.video` | YouTube embed (default: hidden, set `youtube_id` to show) |
+| Testimonials | `alternative.testimonials` | Reuses `testimonial-scroll.html` component (shared) |
+| Stats | `alternative.stats` | Social proof numbers with icons (shared) |
+| FAQs | `alternative.faqs` | Accordion with switching-related questions (shared) |
+| CTA | `alternative.cta` | Final conversion card with buttons (shared) |
+### Dynamic Competitor Name in Frontmatter
+The layout uses `{{ page.resolved.alternative.competitor.name }}` in its frontmatter defaults to dynamically reference the competitor. This works because the template pipes these values through `| uj_liquify` to resolve Liquid expressions.
+**Example:** The layout's default FAQ includes:
+```yaml
+question: "Can I import my data from {{ page.resolved.alternative.competitor.name }}?"
+```
+Which renders as "Can I import my data from ExampleApp?" for an ExampleApp competitor page.
+### Reference Implementation
+- **Minimal competitor page:** `src/defaults/dist/_alternatives/example-competitor.md` — shows the minimum frontmatter needed (competitor name + comparison features)
+- **Layout with all defaults:** `src/defaults/dist/_layouts/themes/classy/frontend/pages/alternatives/alternative.html` — contains shared content for all sections
+### File Locations
+| Purpose | Path |
+|---------|------|
+| Theme layout (alternative page) | `src/defaults/dist/_layouts/themes/classy/frontend/pages/alternatives/alternative.html` |
+| Theme layout (index/listing page) | `src/defaults/dist/_layouts/themes/classy/frontend/pages/alternatives/index.html` |
+| Blueprint (alternative) | `src/defaults/dist/_layouts/blueprint/alternatives/alternative.html` |
+| Blueprint (index) | `src/defaults/dist/_layouts/blueprint/alternatives/index.html` |
+| Default page (index) | `src/defaults/dist/pages/alternatives/index.md` |
+| Sample alternative | `src/defaults/dist/_alternatives/example-competitor.md` |
+| CSS | `src/assets/css/pages/alternatives/alternative/index.scss` |
+| JS | `src/assets/js/pages/alternatives/alternative/index.js` |
 ## Audit Workflow
 When fixing issues identified by the audit task (`src/gulp/tasks/audit.js`):

package/dist/assets/css/pages/alternatives/alternative/index.scss ADDED Viewed

File without changes

package/dist/assets/js/pages/alternatives/alternative/index.js ADDED Viewed

@@ -0,0 +1,20 @@
+/**
+ * Alternatives Page JavaScript
+ */
+// Libraries
+let webManager = null;
+// Module
+export default (Manager) => {
+  return new Promise(async function (resolve) {
+    // Shortcuts
+    webManager = Manager.webManager;
+    // Initialize when DOM is ready
+    await webManager.dom().ready();
+    // Resolve after initialization
+    return resolve();
+  });
+};

package/dist/config/_config_default.yml CHANGED Viewed

@@ -85,3 +85,33 @@ exclude:
 include:
   - .well-known
   - __
+# Jekyll collections
+collections:
+  team:
+    title: "Team Members"
+    output: true
+  updates:
+    title: "Updates"
+    output: true
+  alternatives:
+    title: "Alternatives"
+    output: true
+# Jekyll defaults
+defaults:
+  - scope:
+      path: ""
+      type: "team"
+    values:
+      permalink: "/team/:title"
+  - scope:
+      path: ""
+      type: "updates"
+    values:
+      permalink: "/updates/:title"
+  - scope:
+      path: ""
+      type: "alternatives"
+    values:
+      permalink: "/alternatives/:title"

package/dist/defaults/dist/_alternatives/example-competitor.md ADDED Viewed

@@ -0,0 +1,81 @@
+---
+### ALL PAGES ###
+layout: blueprint/alternatives/alternative
+sitemap:
+  include: true
+### PAGE CONFIG ###
+draft: true  # Hide from listing and sitemap (only visible in development)
+### ALTERNATIVE CONFIG ###
+# Only competitor-specific data is needed here.
+# Shared content (testimonials, stats, FAQs, CTA, why_switch) is inherited from the layout.
+# Override any inherited section by defining it here.
+alternative:
+  competitor:
+    name: "ExampleApp"
+    description: "ExampleApp is a basic project management tool with limited features and outdated design."
+  comparison:
+    features:
+      - name: "Free Plan"
+        icon: "gift"
+        ours:
+          value: true
+        theirs:
+          value: true
+      - name: "AI-Powered Features"
+        icon: "sparkles"
+        ours:
+          value: "Advanced"
+        theirs:
+          value: "Basic"
+      - name: "Real-time Collaboration"
+        icon: "users"
+        ours:
+          value: true
+        theirs:
+          value: false
+      - name: "API Access"
+        icon: "code"
+        ours:
+          value: "Full REST API"
+        theirs:
+          value: "Limited"
+      - name: "Custom Branding"
+        icon: "palette"
+        ours:
+          value: true
+        theirs:
+          value: false
+      - name: "Priority Support"
+        icon: "headset"
+        ours:
+          value: "24/7"
+        theirs:
+          value: "Business hours"
+      - name: "Integrations"
+        icon: "plug"
+        ours:
+          value: "200+"
+        theirs:
+          value: "50+"
+      - name: "Mobile App"
+        icon: "mobile"
+        ours:
+          value: true
+        theirs:
+          value: true
+      - name: "Export Formats"
+        icon: "download"
+        ours:
+          value: "PDF, CSV, JSON"
+        theirs:
+          value: "CSV only"
+      - name: "Uptime SLA"
+        icon: "shield-check"
+        ours:
+          value: "99.99%"
+        theirs:
+          value: "99.5%"
+---

package/dist/defaults/dist/_layouts/blueprint/alternatives/alternative.html ADDED Viewed

@@ -0,0 +1,9 @@
+---
+### ALL PAGES ###
+layout: themes/[ site.theme.id ]/frontend/pages/alternatives/alternative
+asset_path: alternatives/alternative
+### REGULAR PAGES ###
+---
+{{ content | uj_content_format }}

package/dist/defaults/dist/_layouts/blueprint/alternatives/index.html ADDED Viewed

@@ -0,0 +1,12 @@
+---
+### ALL PAGES ###
+layout: themes/[ site.theme.id ]/frontend/pages/alternatives/index
+### REGULAR PAGES ###
+meta:
+  title: "Alternatives - {{ site.brand.name }}"
+  description: "Compare {{ site.brand.name }} to popular alternatives. See why thousands of users choose {{ site.brand.name }} over the competition."
+  breadcrumb: "Alternatives"
+---
+{{ content | uj_content_format }}