Skip to content

jeremylongshore/startaitools.com

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

253 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸš€ Start AI Tools - AI Implementation Platform

Hugo Netlify Status License: MIT PRs Welcome

Business blog and knowledge center for AI deployment, technical guides, and real-world implementation case studies. Built with Hugo and presented by Intent Solutions.

πŸ”— Live Site: startaitools.com

✨ Features

  • πŸ“ Technical Blog - 37+ posts on AI deployment, data engineering, and DevOps
  • πŸ› οΈ Real-World Case Studies - DiagnosticPro platform, BigQuery schemas, RSS validation
  • πŸ“Š AI Engineering Resources - Comprehensive curriculum and research materials
  • 🎨 Professional Design - Clean, fast, business-focused with Archie theme
  • πŸ” SEO Optimized - Structured data, meta tags, sitemap
  • ⚑ Lightning Fast - Static site with optimized builds and aggressive caching
  • πŸ“± Responsive - Mobile-first design with excellent UX

πŸ—οΈ Tech Stack

  • Static Site Generator: Hugo v0.12.0
  • Theme: Archie (Professional business theme)
  • Hosting: Netlify
  • Domain: startaitools.com
  • Build Process: Minified, optimized, cache-controlled
  • Features: Syntax highlighting, code copy buttons, table of contents

πŸ“‚ Content Structure

content/
β”œβ”€β”€ posts/              # Blog posts (37+ technical articles)
β”‚   β”œβ”€β”€ *.md           # Individual blog posts
β”‚   └── startai/       # Synced content subdirectory
β”œβ”€β”€ _index.md          # Homepage
β”œβ”€β”€ about.md           # About page
β”œβ”€β”€ contact.md         # Contact page
β”œβ”€β”€ projects.md        # Projects showcase
β”œβ”€β”€ research.md        # Research & curriculum
β”œβ”€β”€ en/                # Legacy English content structure
β”œβ”€β”€ agentic-design-patterns/  # Design pattern documentation
β”œβ”€β”€ mcp-for-beginners/        # MCP tutorial series
└── tiny-recursive-models/    # ML model documentation

πŸš€ Quick Start

Prerequisites

Local Development

# Clone the repository (or navigate to existing directory)
cd /home/jeremy/projects/blog/startaitools

# Start development server with drafts
hugo server -D

# Start server without drafts (production preview)
hugo server

# Start server accessible from external devices
hugo server -D --bind 0.0.0.0

# View at http://localhost:1313

Build for Production

# Build optimized static site
hugo --gc --minify --cleanDestinationDir

# Output will be in ./public directory

πŸ“ Writing Content

Create New Post

# Create a new blog post
hugo new posts/my-new-post.md

# Create a project page
hugo new projects/my-project.md

Front Matter Template

Posts use YAML format (not TOML):

---
title: "Your Post Title"
date: 2025-10-09T10:00:00-06:00
draft: false
tags: ["ai", "programming", "deployment"]
author: "Jeremy Longshore"
description: "Brief description for SEO and social media"
---

Important: This project uses YAML front matter (delimited by ---), not TOML format.

🎨 Customization

Site Configuration

Edit config/_default/config.toml for site-wide settings:

baseURL = "https://startaitools.com/"
title = "Start AI Tools - Presented by Intent Solutions"
theme = "archie"
author = "Jeremy Longshore"

[params]
description = "Deploy AI solutions in days, not months"

Navigation Menu

The site has a 6-item navigation menu:

  1. Home
  2. Posts
  3. About
  4. Research & Curriculum
  5. Projects
  6. Contact

Edit menu items in config/_default/config.toml under [menu] section.

Custom Styling

The Archie theme provides professional business styling. To customize:

  1. Override theme layouts in layouts/ directory
  2. Add custom CSS in static/css/custom.css
  3. Modify theme parameters in config.toml

πŸ”— Featured Content

Major Blog Post Topics

  1. Data Engineering - BigQuery 254-table schema, data pipelines, RSS validation (226+ feeds)
  2. AI Platforms - DiagnosticPro case studies, AI integration workflows
  3. DevOps Automation - N8N workflows, GitHub Actions, Terraform guides
  4. Documentation Systems - Claude.md, directory standards, AI-assisted writing
  5. Real-World Debugging - Slack integration, COPPA compliance, testing suites

Related Projects

  1. DiagnosticPro - AI-powered diagnostic platform for repair professionals
  2. Intent Solutions - AI deployment and consulting services
  3. AI Engineering Curriculum - Comprehensive learning path
  4. Jeremy Longshore Blog - Personal portfolio and tech blog

🚒 Deployment

Netlify (Current Setup)

The site automatically deploys to Netlify on push to main/master branch:

  • Build command: hugo --gc --minify --cleanDestinationDir
  • Publish directory: public/
  • Hugo version: 0.150.0 (locked in netlify.toml)
  • Node version: 18
  • Domain: startaitools.com with HTTPS force redirect
  • Timezone: America/Chicago

Cache Control Strategy

Aggressive cache-busting configured in netlify.toml:

  • HTML pages: no-cache, no-store, must-revalidate
  • Dynamic routes: public, max-age=0, must-revalidate

This ensures fresh content on every visit while maintaining performance.

Manual Deployment

# Build the site
hugo --gc --minify --cleanDestinationDir

# Deploy public/ directory to any static host
rsync -avz public/ user@server:/var/www/html/

πŸ“ˆ Performance Metrics

  • Lighthouse Score: 95+/100
  • Page Load: < 2s
  • First Contentful Paint: < 800ms
  • Time to Interactive: < 1.5s
  • Total Page Size: Optimized with minification and compression

🀝 Contributing

Contributions are welcome! Please see CONTRIBUTING.md for details.

Development Workflow

  1. Fork the repository (if external contributor)
  2. Create feature branch (git checkout -b feature/amazing-feature)
  3. Test locally with hugo server -D
  4. Commit changes (git commit -m 'Add amazing feature')
  5. Push to branch (git push origin feature/amazing-feature)
  6. Open Pull Request

Content Guidelines

  • Use YAML front matter (not TOML)
  • Include meaningful tags and descriptions
  • Test locally before pushing
  • Follow existing content structure
  • Optimize images before adding

πŸ“„ License

This project is licensed under the MIT License - see LICENSE file for details.

πŸ™ Acknowledgments

  • Hugo - Blazing fast static site generator
  • Archie Theme - Clean, professional business theme
  • Netlify - Seamless hosting and deployment
  • Open source community

πŸ“§ Contact


Deploy AI solutions in days, not months
Presented by Intent Solutions

⭐ Star this project β€’ 🌐 Visit the site β€’ πŸ› Report an issue

About

AI implementation blog with 37+ technical posts on deployment, data engineering, and DevOps. Hugo static site with case studies and engineering resources.

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Sponsor this project

  •  

Contributors