Proto: fastify webserver

.editorconfig

@@ -1,23 +1,30 @@
+# EditorConfig helps developers define and maintain consistent
+# coding styles between different editors and IDEs
+# https://editorconfig.org
+
 root = true
 
 [*]
 indent_style = space
 indent_size = 2
+tab_width = 2
 end_of_line = lf
 charset = utf-8
 insert_final_newline = true
-max_line_length = 120
+max_line_length = 100
+
+[*.json]
+indent_style = tab
+insert_final_newline = true
 
 [*.lua]
+indent_style = space
 indent_size = 4
 
 [*.sql]
+indent_style = space
 indent_size = 4
 
-[*.tsx, *.ts, *.js]
+[*.md]
+indent_style = space
 indent_size = 2
-
-[*.json]
-indent_size = 4
-insert_final_newline = false
-max_line_length = 200

.env.example

@@ -7,6 +7,8 @@ FXSERVER_EXECUTABLE=./FXServer
 # Path to your server-data folder
 FXSERVER_DATA_PATH=./server-data
 
+DEPLOY_PATH=./server-data/resources/[dev-resources]/fxManager
+
 # Config file inside server-data
 FXSERVER_CFG=server.cfg
 

.github/workflows/release.yaml

@@ -39,7 +39,7 @@ jobs:
           git push origin HEAD:main 
 
       - name: Run Build
-        run: bun run build
+        run: bun run build:force
 
       - name: Package Assets
         run: |

.gitignore

@@ -1,9 +1,34 @@
+# Dependencies
 node_modules
-dist/
-data/
+.pnp
+.pnp.js
+
+# Local env files
 .env
-*.db
-*.db-shm
-*.db-wal
-packages/panel/client/dist/
-.turbo/
+.env.local
+.env.development.local
+.env.test.local
+.env.production.local
+
+# Testing
+coverage
+
+# Database files
+data/*.db*
+
+# Turbo
+.turbo
+
+# Vercel
+.vercel
+
+# Build Outputs
+dist
+
+# Debug
+npm-debug.log*
+
+# Misc
+.DS_Store
+*.pem
+.vscode

README.md

@@ -7,35 +7,23 @@ Single binary deployment - no runtime dependencies required on the target machin
 > This project is still in intensive development, it is **not** to be considered stable until a `v1.0.0+` release.
 > If this repository is public, it's for transparency, feedback and open source contributions to help it achieve this milestone.
 
----
-
-## Stack
+## Structure
 
-| Layer             | Tech                            | Location            |
-|-------------------|---------------------------------|---------------------|
-| Runtime           | Bun (compiled into binary)      |                     |
-| Monorepo          | Turbo + Bun Workspaces          |                     |
-| Linting           | Biome (lint + format + imports) |                     |
-| Process Manager   | Bun                             | `packages/core`     |
-| Web Server        | ElysiaJS                        | `packages/core`     |
-| Frontend          | React + Vite SPA                | `packages/panel-ui` |
-| Database          | Bun SQLite + Drizzle ORM        | `packages/database` |
-| FiveM/RedM Bridge | Lua resource                    | `packages/resource` |
-
----
-
-## Project Structure
+Each app/package will have it's own more detailled structure in it's README.
 
 ```
-packages/
-  core/       - Process manager: spawns & supervises FiveM/RedM
-              - Webserver: ElysiaJS API for the panel & game resource communication
-  panel-ui/   - React SPA
-  database/   - Drizzle schema, migrations, repositories
-  resource/   - Drop-in FiveM/RedM Lua resource
-shared/
-  types/      - Shared TypeScript types
-  utils/      - Shared helper functions
+fxManager/
+├── apps/
+│   ├── core/          # Process Manager & Webserver
+│   ├── resource/      # FxServer resource to connect to panel
+│   └── webpanel/      # React SPA served by the webserver
+├── packages/
+│   ├── database/      # Drizzle schema & Migration handler
+│   ├── shared/        # Enums, types, and utils
+│   └── ui/            # Shared React ShadCN components
+├── biome.json         # Root linting/formatting
+├── package.json       # Workspace definitions
+└── turbo.json         # Build pipeline config
 ```
 
 ---
@@ -50,7 +38,7 @@ bun install
 bun dev
 ```
 
-The React dev server runs on `:5173` and proxies API/WS calls to Elysia on `:4000`.
+The React dev server runs on `:5173` and proxies API/WS calls on `:3000`.
 
 ---
 
@@ -64,7 +52,25 @@ bun typecheck    # tsc --noEmit across all packages (via Turbo)
 bun db:studio    # open Drizzle Studio to browse the database (optional)
 ```
 
-### Adding a migration
+---
+
+## Development & Code Quality
+
+* **`bun lint`** – Runs linting across the entire monorepo to find and fix code smells.
+* **`bun format`** – Automatically formats all source code and internal build scripts.
+* **`bun typecheck`** – Validates TypeScript types across all packages via Turbo.
+* **`bun db:studio`** – Opens a browser-based GUI to manage and browse your database.
+* **`bun build`** – Compiles all packages and prepares the production bundle.
+* **`bun dev`** – Starts the development environment with hot-reloading.
+
+### Game Resource ( [`apps/resource`](./apps/resource) )
+Commands specific to the game-side resource and NUI:
+
+* **`bun web:dev`** – Runs the Vite dev server for the NUI frontend.
+* **`bun watch`** – Rebuilds the resource automatically as you save files.
+* **`bun deploy`** – Bundles the resource and copies it to the path defined in your `DEPLOY_PATH` environment variable.
+
+## Adding a migration
 
 Edit `packages/database/src/migrations/index.ts` and append to the array:
 
@@ -88,11 +94,11 @@ Biome handles everything ESLint + Prettier would - faster, single config at the
 
 ```bash
 # Build for both platforms
-bun run build.ts
+bun run build
 
 # Build for a specific platform
-bun run build.ts --target=linux
-bun run build.ts --target=windows
+bun run build --target=linux
+bun run build --target=windows
 ```
 
 Turbo caches build outputs - subsequent builds only rebuild what changed.
@@ -137,9 +143,15 @@ The panel will be available at `http://your-server-ip:4000`.
 
 ## Environment Variables
 
-| Variable              | Default           | Description                       |
-|-----------------------|-------------------|-----------------------------------|
-| `PANEL_PORT`          | `4000`            | Web panel port                    |
-| `FXSERVER_EXECUTABLE` | `./FXServer`      | Path to FXServer binary           |
-| `FXSERVER_DATA_PATH`  | `./server-data`   | Path to server-data folder        |
-| `FXSERVER_CFG`        | `server.cfg`      | Config file name inside data path |
+| Variable              | Default           | Description                          |
+|-----------------------|-------------------|--------------------------------------|
+| `FXSERVER_EXECUTABLE` | `./FXServer`      | Path to FXServer binary              |
+| `FXSERVER_DATA_PATH`  | `./server-data`   | Path to server-data folder           |
+| `FXSERVER_CFG`        | `server.cfg`      | Config file name inside data path    |
+| `PANEL_PORT`          | `3000` (opt)      | Web panel port                       |
+| `COOKIE_SECRET`       | N/A (opt)         | Defines the secret for cookie sign   |
+| `DEPLOY_PATH`         | N/A               | Used in development for the resource |
+
+## Errrh anything else ?
+
+![dumb monke](.github/image.png)

apps/core/.gitignore

@@ -0,0 +1,34 @@
+# dependencies (bun install)
+node_modules
+
+# output
+out
+dist
+*.tgz
+
+# code coverage
+coverage
+*.lcov
+
+# logs
+logs
+_.log
+report.[0-9]_.[0-9]_.[0-9]_.[0-9]_.json
+
+# dotenv environment variable files
+.env
+.env.development.local
+.env.test.local
+.env.production.local
+.env.local
+
+# caches
+.eslintcache
+.cache
+*.tsbuildinfo
+
+# IntelliJ based IDEs
+.idea
+
+# Finder (MacOS) folder config
+.DS_Store

apps/core/README.md

@@ -0,0 +1,12 @@
+# core
+
+## WebServer
+
+### Endpoint Groups
+
+All endpoints are placed in one of two groups, these define what they're used for as well as security for them.
+
+| Prefix        | |
+|---------------|-----------------------------------------|
+| `/api/*`      | Endpoints used for the webpanel         |
+| `/internal/*` | Endpoints used by the fxserver resource |

apps/core/package.json

@@ -0,0 +1,28 @@
+{
+	"name": "@fxmanager/core",
+	"module": "index.ts",
+	"type": "module",
+	"private": true,
+	"scripts": {
+		"dev": "bun --watch src/index.ts",
+		"start": "bun src/index.ts",
+		"lint": "biome lint ./src",
+		"format": "biome format --write ."
+	},
+	"devDependencies": {
+		"@types/bun": "latest",
+		"@types/node": "^25.5.0"
+	},
+	"peerDependencies": {
+		"typescript": "^5"
+	},
+	"dependencies": {
+		"@fastify/cookie": "^11.0.2",
+		"@fastify/static": "^9.0.0",
+		"@fastify/websocket": "^11.2.0",
+		"@fxmanager/database": "workspace:*",
+		"@fxmanager/shared": "workspace:*",
+		"@sinclair/typebox": "^0.34.49",
+		"fastify": "^5.8.4"
+	}
+}

apps/core/src/common/config.ts

@@ -0,0 +1,35 @@
+import type { CoreConfig, PlatformOS } from '@fxmanager/shared/types';
+import { repo } from '@fxmanager/database';
+
+function getPlatform(): PlatformOS {
+	if (process.platform === 'win32') {
+		return 'windows';
+	} else if (process.platform === 'linux' || process.platform === 'darwin') {
+		return 'linux';
+	} else {
+		return 'unknown';
+	}
+}
+
+const DEFAULTS: CoreConfig = {
+	platform: getPlatform(),
+	executable: process.env.FXSERVER_EXECUTABLE || './FXServer',
+	serverDataPath: process.env.FXSERVER_DATA_PATH || './server-data',
+	configFile: process.env.FXSERVER_CFG || 'server.cfg',
+	autoRestart: true,
+	maxRestarts: 5,
+	restartDelayMs: 5000,
+	webServerPort: process.env.PANEL_PORT ? Number(process.env.PANEL_PORT) : 3000,
+	// used for fxserver resource -> process manager communications
+	resourceApiToken: crypto.randomUUID(),
+	cookieSecret: process.env.COOKIE_SECRET ?? crypto.randomUUID(),
+};
+
+export function loadConfig(): CoreConfig {
+	const stored = repo.settings.get<Partial<CoreConfig>>('server.config');
+	return { ...DEFAULTS, ...stored };
+}
+
+export function saveConfig(config: Partial<CoreConfig>) {
+	repo.settings.set('server.config', config);
+}

apps/core/src/common/env.ts

@@ -0,0 +1,36 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { isProduction } from './utils';
+
+/**
+ * Manually loads environment variables in `process.env` from the root `.env` file.
+ * Used only in development when the runtime is expecting the `.env` file to be in apps/core.
+ */
+
+if (!isProduction) {
+	const envPath = join(process.cwd(), '../..', '.env');
+
+	if (existsSync(envPath)) {
+		const lines = readFileSync(envPath, 'utf-8').split('\n');
+
+		for (const line of lines) {
+			const trimmed = line.trim();
+			if (!trimmed || trimmed.startsWith('#')) continue;
+
+			const eq = trimmed.indexOf('=');
+			if (eq === -1) continue;
+
+			const key = trimmed.slice(0, eq).trim();
+			const value = trimmed
+				.slice(eq + 1)
+				.trim()
+				.replace(/^["']|["']$/g, ''); // Removes quotes
+
+			if (!(key in process.env)) process.env[key] = value;
+		}
+
+		console.log(`[core] Loaded .env from ${envPath}.`);
+	} else {
+		console.log(`[core] No .env found at ${envPath}.`);
+	}
+}

apps/core/src/common/utils.ts

@@ -0,0 +1,8 @@
+import { repo } from '@fxmanager/database';
+
+export const isProduction = process.env.NODE_ENV === 'production';
+export const COOKIE_NAME = 'fxm_session';
+
+export function isFxManagerSetup() {
+	return repo.auth.countUsers() > 0;
+}