LuaBlox Docs
Luax Pro Documentation
Complete guide to installing, configuring, and deploying Luax Pro. Search all documentation pages.
Why Lua Static Site Generator?
Understand why Luax Pro uses pure Lua instead of Node.js, and why that matters for speed, simplicity, and long-term maintenance.
Install Lua 5.4
Step-by-step guide to installing Lua 5.4 on Windows, macOS, and Linux. Lua is the only runtime Luax Pro needs.
Download Luax Pro and Prepare Your Project
Get the Luax Pro package from Gumroad, extract it, and understand the folder structure before building your first site.
Install and Run Luax
Make the Luax binary executable and run your first build. This guide covers Windows, macOS, and Linux.
Run Decap CMS Locally
Start both the Luax build server and the Decap CMS proxy in two terminals to edit content through a graphical admin panel.
Log In to Decap CMS
Access the Decap CMS admin panel locally and understand the interface for editing your site content.
Update Site Metadata
Configure your site title, description, navigation, footer, and social links through Decap CMS or by editing metadata.yaml directly.
Update Homepage Content
Edit the hero section, problem statement, features, pricing tiers, testimonials, and FAQ on your homepage through Decap CMS or directly in index.md.
Update FAQ Page
Add, edit, or remove frequently asked questions through Decap CMS or by editing faq.md directly.
Update About Page
Edit your studio mission, founder profile, toolchain, and timeline through Decap CMS or by editing about.md directly.
Update Contact Page
Configure your contact form, Formspree endpoint, project types, budget ranges, and direct contact channels.
Update All Controller Files
Understand what controller files are, how they differ from collection items, and how to edit them through Decap CMS or directly.
Docs Collection
Add, edit, and organize documentation pages in the src/docs folder. This guide covers creating new docs, ordering them, and linking them in the docs controller.
Services Collection
Add and edit service packages in the src/services folder. This guide covers service frontmatter fields, pricing tiers, FAQ items, and how the listing page works.
Projects Collection
Add and edit project case studies in the src/projects folder. This guide covers project frontmatter fields, gallery images, code excerpts, and the listing page.
Push Your Project to GitHub
Create a GitHub repository and push your Luax Pro project so it can be connected to Netlify, Cloudflare, Vercel, or any other host.
Deploy to Netlify with Decap CMS
Connect your GitHub repository to Netlify, enable Netlify Identity and Git Gateway, and set up a custom domain so Decap CMS works in production.
Deploy to Cloudflare, Vercel, or Any Static Host
Deploy a built Luax Pro site to Cloudflare Pages, Vercel, GitHub Pages, AWS S3, cPanel, or a VPS. Decap CMS runs locally for editing, not in production.