backend/

PROJECT_NAME

Generated by kool create go-react.

Usage

go run ./cmd/__PROJECT_NAME__

To mount the app under a sub-route, pass --route-prefix:

go run ./cmd/__PROJECT_NAME__ --route-prefix my-app

Then open http://localhost:<port>/my-app/.

Development

Dev Mode (recommended)

Starts Vite (HMR) and rebuilds the Go API with air on .go changes:

go run ./script/dev

Options:

go run ./script/dev --port 9000
go run ./script/dev --no-air          # single go run, still external Vite
go run ./script/dev --no-open

Plain in-process Vite (no air) is still available:

go run ./cmd/__PROJECT_NAME__ --dev

External React Source

The generated frontend includes an external_src/ directory next to src/. Code in that directory can be imported with the @external_src alias:

import { ExternalDemo } from '@external_src/demo-external/frontend/src/ExternalDemo';

Release Mode (Production Build)

1. Build the frontend:

go run ./script/build-frontend

1. Run the server (embeds the built frontend):

go run ./cmd/__PROJECT_NAME__

Build / Install

go run ./script/build-frontend && go run ./script/build
go run ./script/install