Sandbox Jekyll documentation

Demo Pages Configuration

Complete guide to understanding and customizing demo pages in the Sandbox Jekyll theme

Demo Pages Overview

Basic Structure

Demo pages are configured through individual markdown files in the root directory (e.g., demo1.md, demo2.md). Each demo uses specific includes from _includes/components/sections/ directories.

---
layout: demo14
title: Demo Layout 14
permalink: /demo14/

# Hero Section
hero:
  title: Creative. Smart. Awesome.
  subtitle: We are an award winning digital agency that strongly believes in the power of creative ideas.
  button:
    text: Read More
    url: /about
    
# Projects Section
projects:
  title: Our Projects
  subtitle: Check out some of our awesome projects with creative ideas.
---

Include Structure

Each demo has its own includes folder at _includes/components/sections/demo{number}/ containing section-specific templates.

_includes/
  └── components/
      └── sections/
          ├── demo1/
          │   ├── hero.html
          │   ├── about.html
          │   └── projects.html
          ├── demo2/
          │   ├── header.html
          │   └── portfolio.html
          └── demo3/
              ├── services.html
              └── testimonials.html

Common Section Types

Hero Sections

Hero sections are typically the first visual element and can be configured with various styles and content.

hero:
  style: "carousel"  # Options: basic, video, carousel
  title: "Welcome to Sandbox"
  subtitle: "Build better websites with Sandbox"
  background_image: "/assets/img/photos/bg1.webp"
  buttons:
    - text: "Get Started"
      url: "/contact"
      style: "primary"
    - text: "Learn More"
      url: "/about"
      style: "outline"

Project Showcases

Project sections can be displayed in various formats including grids, carousels, and masonry layouts.

projects:
  title: "Latest Projects"
  title_class: "fs-16 text-uppercase text-muted mb-3"
  main_title: "Check out some of our awesome projects"
  project_items:
    - image: "/assets/img/photos/pd1.webp"
      category: "Development"
      title: "Project Title"
      url: "/single-project.html"

Layout Customization

Color Schemes

Each demo can use custom color schemes defined in the frontmatter or section configurations.

colors:
  primary: "purple"
  secondary: "yellow"
  background: "light"
  
sections:
  about:
    background_color: "soft-primary"
    text_color: "primary"
  services:
    background_color: "gray"
    text_color: "dark"

Common Components

Configure navigation styles and menu items for each demo layout.

navigation:
  style: "transparent"  # Options: solid, transparent, sticky
  color: "light"        # Options: light, dark
  button:
    text: "Contact"
    url: "/contact"
    style: "primary"

Different footer layouts and content configurations available for each demo.

footer:
  style: "widget"  # Options: simple, widget, extended
  background: "dark"
  logo: "/assets/img/logo-light.webp"
  widgets:
    - title: "About Us"
      content: "Company description here"
    - title: "Contact Info"
      contact_details: true

Demo Categories

Corporate Demos (Demo1-Demo8)

Corporate demos feature business-focused layouts with sections for services, team members, and company information.

{% include components/sections/demo1/services.html %}
{% include components/sections/demo1/team.html %}
{% include components/sections/demo1/solutions.html %}

# Common sections in corporate demos:
- Hero with business messaging
- Service offerings
- Team showcase
- Client testimonials
- Case studies/portfolio
- Contact information

Creative Agency Demos (Demo9-Demo15)

Agency demos emphasize portfolio work, creative services, and dynamic visual elements.

portfolio:
  style: "grid"  # Options: grid, masonry, carousel
  items_per_row: 3
  show_filters: true
  categories:
    - Branding
    - Digital
    - Motion
  items:
    - title: "Project Name"
      category: "Branding"
      image: "/assets/img/portfolio/1.webp"

Product/App Demos (Demo16-Demo23)

Product-focused demos showcase features, pricing plans, and app screenshots.

features:
  layout: "grid"  # Options: grid, tabs, accordion
  items:
    - icon: "uil-mobile-android"
      title: "Mobile Ready"
      description: "Responsive design that works on all devices"
      
pricing:
  period_toggle: true  # Enable monthly/yearly toggle
  plans:
    - name: "Basic"
      price: 
        monthly: 19
        yearly: 199
      features:
        - "5 Projects"
        - "100 GB Storage"

Landing Pages (Demo24-Demo34)

Conversion-focused landing pages with clear CTAs and marketing elements.

cta:
  style: "fullwidth"  # Options: fullwidth, boxed, split
  background: "primary"
  title: "Ready to get started?"
  button:
    text: "Sign Up Now"
    url: "/signup"
    
testimonials:
  style: "carousel"
  autoplay: true
  items:
    - author: "John Doe"
      company: "Company Name"
      content: "Testimonial text here"

Advanced Customization

Custom Section Creation

Create new sections by adding HTML templates to your demo’s section folder.

# File: _includes/components/sections/demo1/custom-section.html

  
    
      
        {{ page.custom_section.title }}
        {{ page.custom_section.content }}

Component Variations

Customize existing components with different styles and layouts.

hero_variations:
  - style: "basic"
    classes: "bg-light"
  - style: "video"
    video_url: "path/to/video.mp4"
  - style: "carousel"
    interval: 5000
  - style: "parallax"
    image: "background.webp"

Best Practices

Performance Optimization

  • Use appropriate image sizes and formats
  • Minimize custom JavaScript
  • Leverage built-in lazy loading
  • Utilize CSS utility classes

Responsive Design Guidelines

  • Use Bootstrap grid system consistently
  • Test on multiple device sizes
  • Implement mobile-first approach
  • Consider touch interfaces