Minimal lua Themes LUAX SSG
Free download and open source code lua Minimalis clean project website blog themes template.

Introduction

A starter project for LUAX LUA SSG

LUAX is a static site generator built with Lua. It was created to make building static websites simple, fast, and fun.

Lua is lightweight, fast, and easy to learn. It's often used in game development and embedded systems, but it's also perfect for building CLI tools and web generators.

Features

LUAX LUA SSG STATIC SITE GENERATOR MAGIC FEATURES:

📝 Markdown content with YAML frontmatter

🏷️ Automatic tag pages

📄 Pagination for blog posts

🎨 Custom layouts with LAX template engine

🔍 SEO with Open Graph, JSON-LD, and sitemap

📡 RSS feed for your blog

🖼️ Asset management with public folder

🚀 Blazing fast builds

Philosophy

The LUAX LUA Static Site Generator SSG Philosophy:

• Simple — No unnecessary complexity
• Transparent — You control everything
• Performant — Build time should not waste your time
• Portable — Works on any platform

Get Start

For first you need to download lua : https://www.lua.org/download.html

Next open terminal and clone this project

git clone https://github.com/yourusername/luax.git
cd luax

Windows

Build your project

luax build

Run your project

luax start

Access on http://localhost:8080

Linux MacOs

Prepare

chmod +x luax.sh

Build your project

./luax.sh build 

Run your project

./luax.sh start

Access on http://localhost:8080

Architecture

The LUAX Architecture

luax/
├── build.lua          # Build engine
├── start.lua          # Development server
├── lax.lua            # LAX template engine
├── yaml.lua           # YAML parser
├── metadata.yaml      # Site configuration
├── luax.bat           # Windows command line
├── luax.sh            # Linux/Mac command line
├── src/
│   ├── posts/         # Blog posts (.md)
│   └── pages/         # Static pages (.md)
├── templates/
│   ├── layouts/       # Layout templates (.lax)
│   └── partials/      # Partial templates (.lax)
├── public/            # Static assets (css, img, js)
├── dist/              # Generated output

Setup

For first you can configuration your SEO website access on data/metadata.yaml

format

title: LUAX SSG
description: Static Site Generator built with Lua
url: http://localhost:8080
image: /img/logo.webp
favicon: /img/favicon.webp

Media

You can upload your static folder in public such css , image, video , file and others.

Content

Static Page

To update static page you can access on src/pages then create a new markdown file , example about.md

format:

---
title: About LUAX
description: LUAX is a simple static site generator built with Lua. Learn about the project, why we built it, and how it works.
layout: page.lax
image: /img/darkluax2.webp
---
## About LUAX SSG
LUAX is a **static site generator built with Lua**. It was created to make building static websites simple, fast, and fun.

Posts Article

To update your blog post article you can simply access on src/posts , and create your new markdown file, example deploy.md.

Format:

---
layout: post.lax
title: Deploying LUAX Sites
date: 2026-07-15
image: /img/neonluax.webp
author: Axcora
tags: deployment, github-pages, netlify
excerpt: Learn how to deploy your LUAX site to production.
---
# Deploying LUAX Sites
Deploy your LUAX site to any hosting platform.

Deploy

Next you can build production with run this command

luax build

and upload your dist folder in to your hosting.

Github pages is ready with deploy.yml just rename deploy.yml.example to be deploy.yml - Next activate your github pages.

Support

• Support via PayPal
• Support via Github
• Support via Gumroad