mleku/next.orly.dev

Files

Enable dev mode for React app with proxy support; refine build, styles, and UI.

- Adjusted `package.json` scripts for Bun dev server and build flow.
- Added `dev.html` for standalone web development with hot-reload enabled.
- Introduced `WebDisableEmbedded` and `WebDevProxyURL` configurations to support proxying non-API paths.
- Refactored server logic to handle reverse proxy for development mode.
- Updated `App.jsx` structure, styles, and layout for responsiveness and dynamic padding.
- Improved login interface with logo support and cleaner design.
- Enhanced development flow documentation in `README.md`.

2025-09-21 10:29:17 +01:00

2.1 KiB

Raw Blame History

Orly Web Application

This is a React web application that uses Bun for building and bundling, and is automatically embedded into the Go binary when built.

Prerequisites

Bun - JavaScript runtime and toolkit
Go 1.16+ (for embedding functionality)

Development

There are two ways to develop the web app:

Standalone (recommended for hot reload)

Start the Go relay with the embedded web UI disabled so the React app can run on its own dev server with HMR.
Configure the relay via environment variables:

# In another shell at repo root
export ORLY_WEB_DISABLE=true
# Optional: if you want same-origin URLs, you can set a proxy target and access the relay on the same port
# export ORLY_WEB_DEV_PROXY_URL=http://localhost:5173

# Start the relay as usual
go run .

Then start the React dev server:

cd app/web
bun install
bun dev

When ORLY_WEB_DISABLE=true is set, the Go server still serves the API and websocket endpoints and sends permissive CORS headers, so the dev server can access them cross-origin. If ORLY_WEB_DEV_PROXY_URL is set, the Go server will reverse-proxy non-/api paths to the dev server so you can use the same origin.

Embedded (no hot reload)

Build the web app and run the Go server with defaults:

cd app/web
bun install
bun run build
cd ../../
go run .

Building

The React application needs to be built before compiling the Go binary to ensure that the embedded files are available:

# Build the React application
cd app/web
bun install
bun run build

# Build the Go binary from project root
cd ../../
go build

How it works

The React application is built to the app/web/dist directory
The Go embed directive in app/web.go embeds these files into the binary
When the server runs, it serves the embedded React app at the root path

Build Automation

You can create a shell script to automate the build process:

#!/bin/bash
# build.sh
echo "Building React app..."
cd app/web
bun install
bun run build

echo "Building Go binary..."
cd ../../
go build

echo "Build complete!"

Make it executable with chmod +x build.sh and run with ./build.sh.

2.1 KiB Raw Blame History