Exact Assembly Website

A Jekyll-based website for Exact Assembly, LLC - migrated from Hugo/Blowfish to Jekyll for GitHub Pages hosting.

Local Development

Prerequisites

• Ruby 2.7 or higher
• Bundler (gem install bundler)

Setup

# Install dependencies
bundle install

# Run local server
bundle exec jekyll serve

# Visit http://localhost:4000

Deployment to GitHub Pages

Option 1: GitHub Actions (Recommended)

1. Push this repository to GitHub
2. Go to Settings → Pages
3. Under "Build and deployment", select "GitHub Actions"
4. The site will automatically build and deploy on each push to main

Option 2: Deploy from Branch

1. Push this repository to GitHub
2. Go to Settings → Pages
3. Under "Build and deployment", select "Deploy from a branch"
4. Select main branch and / (root) folder
5. Click Save

Project Structure

├── _config.yml          # Site configuration
├── _layouts/            # Page templates
│   ├── default.html     # Base layout
│   ├── home.html        # Homepage layout
│   ├── page.html        # Standard pages
│   ├── post.html        # Blog posts
│   └── service.html     # Service pages
├── _includes/           # Reusable components
│   ├── header.html
│   └── footer.html
├── _posts/              # Blog posts (YYYY-MM-DD-title.md)
├── _services/           # Service pages
├── assets/
│   ├── css/main.css     # Styles
│   ├── js/main.js       # JavaScript
│   └── images/          # Images and icons
├── about/               # About page
├── blog/                # Blog index
├── contact/             # Contact page
├── services/            # Services index
└── index.html           # Homepage

Customization

Adding a Blog Post

Create a new file in _posts/ with the format YYYY-MM-DD-title.md:

---
layout: post
title: "Your Post Title"
date: 2024-01-15
author: Your Name
tags: [tag1, tag2]
description: "Brief description for SEO"
image: /assets/images/post-image.jpg  # Optional
---

Your content here...

Adding a Service

Create a new file in _services/:

---
title: Service Name
summary: Brief description
weight: 5  # Order in listings (lower = first)
icon: |
  <svg>...</svg>  # Optional custom icon
---

Service content here...

Updating Contact Form

The contact form uses Formspree. To enable it:

1. Create a Formspree account
2. Create a new form
3. Replace your-form-id in contact/index.html with your form ID

Custom Domain Setup

1. Add a CNAME file to the repository root containing your domain:

   www.xassembly.com
   

2. Configure DNS with your domain provider:

   • Add a CNAME record pointing www to yourusername.github.io
   • Or add A records pointing to GitHub's IP addresses

3. Enable HTTPS in repository Settings → Pages

Credits

• Built with Jekyll
• Hosted on GitHub Pages
• Fonts: DM Sans, Source Sans 3, JetBrains Mono

---

© 2024 Exact Assembly, LLC. All rights reserved.