What Is the Projects Collection?
The src/projects/ folder contains your project case studies. Each .md file becomes a project detail page at /projects/. The listing page at /projects/ shows all projects as cards with pagination.
Every project file uses layout: project-detail.lax in its frontmatter.
Via Decap CMS
1. Open http://localhost:8080/admin/
2. Click Projects in the left sidebar
3. You will see a list of existing projects
4. Click any project to edit it, or click New Project to create one
5. Fill in the fields:
| Field | What It Controls |
|---|---|
| Title | Project name shown on card and detail page |
| Genre | Game genre (e.g., Simulator, Obby, Tycoon) |
| Visits | Total visits (e.g., 48.4M Visits) |
| Ccu | Peak concurrent users (e.g., 14,200 Peak CCU) |
| Retention | Retention stats (e.g., D1 38% / D7 14%) |
| Client | Studio name |
| Role | Your role on the project |
| Stack | Tech stack used |
| Image | Main card image path |
| Highlights | Engineering highlights list |
| Gallery | Gallery image paths |
| Code Filename | Filename shown in the code window |
| Code Lines | Code excerpt lines |
| Body | Long-form case study content |
6. Click Publish
Via Code
Create a new file in src/projects/. For example, src/projects/puzzle-quest.md:
layout: project-detail.lax
title: Puzzle Quest Adventure
description: A 200-level puzzle platformer with co-op mode and daily challenges.
genre: Puzzle
visits: 5.2M Visits
ccu: 1,800 Peak CCU
retention: D1 42% / D7 18%
client: MindBend Studio
role: Lead Gameplay Programmer
stack: Luau --!strict · Fusion · ProfileStore
image: /images/project_puzzle.jpg
highlights:
- Built 200 hand-crafted puzzle levels with progressive difficulty curves.
- Implemented two-player co-op with synchronized state replication.
- Added daily challenge system with global leaderboard rankings.
gallery:
- /images/project_puzzle.jpg
- /images/project_obby_adventure.jpg
code_filename: ServerScriptService/PuzzleValidator.luau
code_lines:
- 'local PuzzleValidator = {}'
- ''
- 'function PuzzleValidator.CheckSolution(grid: {{number}}, solution: {{number}}): boolean'
- ' for i = 1, #grid do'
- ' if grid[i] ~= solution[i] then return false end'
- ' end'
- ' return true'
- 'end'
- ''
- 'return PuzzleValidator'
## Architecture & Challenge
MindBend Studio needed a puzzle engine that could validate player solutions in under 50ms without server lag, while supporting two-player co-op on separate devices.
## Server-Authoritative Validation
All puzzle solutions are validated on the server. The client sends a solution grid, the server compares it against the stored answer, and responds with success or failure. This prevents cheaters from bypassing puzzles with client-side exploits.
## Co-Op Synchronization
Two-player co-op required synchronized state replication without input lag. We used a lightweight RemoteEvent protocol with client prediction and server reconciliation, keeping input latency under 80ms on average.
The Code Excerpt
Each project has a code_lines array. On the detail page, these lines render inside a code window with syntax highlighting classes. Each line is a separate string in the array.
Important: Lua code contains characters like {, }, :, and ' that can break YAML parsing. Wrap every line in single quotes:
code_lines:
- 'local foo = { bar = 1 }'
- 'print(foo.bar)'
If a line contains a single quote, use double quotes or escape it. For example:
code_lines:
- "local msg = 'hello'"
The Gallery
Each project has a gallery array of image paths. On the detail page, these render as a grid of screenshots. The first image is typically the same as the image field.
Place gallery images in public/images/. Recommended size: 1024x768 pixels.
The Listing Page
The listing at /projects/ is generated by src/projects.md, which uses layout: collections.lax. Each project appears as a card with:
- Image
- Genre
- Visits
- Title
- Description (the
descriptionfield) - CCU
- Link to detail page
The card grid shows 6 projects per page (controlled by pagination: 6 in src/projects.md).
Adding a Project to the Homepage
The homepage (src/index.md) has a projects_section with a hardcoded list of three projects. If you want a new project to appear there, add it manually:
projects_section:
items:
- title: Puzzle Quest Adventure
url: /projects/puzzle-quest/
genre: Puzzle
visits: 5.2M Visits
performance: 60 FPS
ccu: 1,800 Peak CCU
description: A 200-level puzzle platformer with co-op mode.
image: /images/project_puzzle.jpg
alt: Puzzle Quest Adventure screenshot
Common Mistake: Unescaped YAML in Code Lines
Lua code with curly braces, colons, or special characters must be quoted. If you see a YAML parse error when building, check your code_lines array for unquoted strings.
Bad:
code_lines:
- local foo = { bar = 1 }
Good:
code_lines:
- 'local foo = { bar = 1 }'
Common Mistake: Missing Layout
If you forget layout: project-detail.lax, the file renders as a generic page without gallery or code window. Always include the layout field at the top of every project file.
Next Step
All collections are understood. You now have the complete knowledge to build, edit, and deploy a Luax Pro site.