Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
50 changes: 50 additions & 0 deletions .github/workflows/deploy.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,50 @@
name: Deploy to GitHub Pages

on:
push:
branches:
- main
workflow_dispatch:

permissions:
contents: read
pages: write
id-token: write

concurrency:
group: pages
cancel-in-progress: false

jobs:
build:
runs-on: ubuntu-latest
steps:
- name: Checkout
uses: actions/checkout@v4

- name: Setup Node.js
uses: actions/setup-node@v4
with:
node-version: 20

- name: Install dependencies
run: npm install @docmd/core

- name: Build site
run: npx @docmd/core build

- name: Upload Pages artifact
uses: actions/upload-pages-artifact@v3
with:
path: ./site

deploy:
needs: build
runs-on: ubuntu-latest
environment:
name: github-pages
url: ${{ steps.deployment.outputs.page_url }}
steps:
- name: Deploy to GitHub Pages
id: deployment
uses: actions/deploy-pages@v4
3 changes: 3 additions & 0 deletions .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -38,3 +38,6 @@ resources/cache/
*.tmp
*.temp
.tmp/


site
3 changes: 3 additions & 0 deletions .lycheeignore
Original file line number Diff line number Diff line change
Expand Up @@ -19,3 +19,6 @@

# Local file links (false positives — these are GitHub-relative URLs)
^file://

# Link for local developement because PR
https://sammethot.github.io/learn-fivem
File renamed without changes.
2 changes: 2 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,8 @@

If you've ever opened a FiveM resource on GitHub and felt lost - this fixes that.

Prefer reading it as a Website? Explore the full course website here: https://sammethot.github.io/learn-fivem

---

## Who This Is For
Expand Down
136 changes: 136 additions & 0 deletions docmd.config.js
Original file line number Diff line number Diff line change
@@ -0,0 +1,136 @@
export default defineConfig({
title: 'FiveM School',
url: 'https://sammethot.github.io/learn-fivem',
src: '.',
minify: true,
autoTitleFromH1: true,
copyCode: true,
pageNavigation: true,

layout: {},

navigation: [
{ title: 'Home', path: './index', icon: 'house' },
{ title: 'Full Index', path: './FULL-INDEX', icon: 'list' },

{
title: 'Basics',
icon: 'book-open',
children: [
{ title: 'What Is FiveM?', path: '/01-basics/01-what-is-fivem' },
{ title: 'Lua Crash Course', path: '/01-basics/02-lua-crash-course' },
{ title: 'Client vs Server', path: '/01-basics/03-client-vs-server' },
{ title: 'Resources & fxmanifest', path: '/01-basics/04-resources-and-fxmanifest' },
],
},

{
title: 'Events',
icon: 'radio',
children: [
{ title: 'Local Events', path: '/02-events/01-local-events' },
{ title: 'Network Events', path: '/02-events/02-net-events' },
{ title: 'Event Security', path: '/02-events/03-event-security' },
{ title: 'Callbacks', path: '/02-events/04-callbacks' },
],
},

{
title: 'Natives',
icon: 'cpu',
children: [
{ title: 'What Are Natives?', path: '/03-natives/01-what-are-natives' },
{ title: 'Common Natives', path: '/03-natives/02-common-natives' },
],
},

{
title: 'Database',
icon: 'database',
children: [
{ title: 'oxmysql Basics', path: '/04-database/01-oxmysql-basics' },
{ title: 'Queries & Security', path: '/04-database/02-queries-and-security' },
],
},

{
title: 'Frameworks',
icon: 'layers',
children: [
{ title: 'QBox Basics', path: '/05-frameworks/01-qbox-basics' },
{ title: 'ESX Basics', path: '/05-frameworks/02-esx-basics' },
{ title: 'QBCore Basics', path: '/05-frameworks/03-qbcore-basics' },
],
},

{
title: 'ox Libraries',
icon: 'package',
children: [
{ title: 'ox_lib', path: '/06-ox-libraries/01-ox-lib' },
{ title: 'ox_target', path: '/06-ox-libraries/02-ox-target' },
{ title: 'Inventories', path: '/06-ox-libraries/03-inventories' },
],
},

{
title: 'NUI (HTML UI)',
icon: 'monitor',
children: [
{ title: 'NUI Basics', path: '/07-nui/01-nui-basics' },
{ title: 'React NUI', path: '/07-nui/02-react-nui' },
],
},

{
title: 'Security',
icon: 'shield',
children: [
{ title: 'Security Checklist', path: '/08-security/01-security-checklist' },
],
},

{
title: 'Performance',
icon: 'gauge',
children: [
{ title: 'Threads & Waits', path: '/09-performance/01-threads-and-waits' },
{ title: 'Optimization Patterns', path: '/09-performance/02-optimization-patterns' },
],
},

{
title: 'First Projects',
icon: 'rocket',
children: [
{ title: 'Hello Resource', path: '/10-first-projects/01-hello-resource' },
{ title: 'Shop', path: '/10-first-projects/02-shop' },
{ title: 'NUI Menu', path: '/10-first-projects/03-nui-menu' },
],
},
],

theme: {
name: 'default',
appearance: 'dark', // Options: 'light', 'dark', 'system'
},

plugins: {
git: {
repo: 'https://github.com/SamMethot/learn-fivem',
branch: 'main',
editLink: true,
lastUpdated: true,
commitHistory: true,
maxCommits: 5
}
},

footer: {
style: 'minimal', // 'minimal' or 'complete'
copyright: '© 2026 learn-fivem. All rights reserved.',
description: 'Documentation built with docmd.',
},


});
Loading
Loading