server

module

v0.0.0-...-cafd142 Latest Latest Go to latest Published: Jan 11, 2026 License: MIT

Details

Valid go.mod file
Redistributable license
Tagged version
Stable version
Learn more about best practices

Repository

github.com/gopl-dev/server

Links

Open Source Insights

README ¶

🚀 Serving gopl.dev

templ live watch & reload

go tool templ generate --watch --proxy="http://localhost:8080" --cmd="go run ./cmd/server/main.go"

tailwind watch

tailwindcss -i ./frontend/assets/input.css -o ./frontend/assets/output.css --watch

linting

https://golangci-lint.run/docs/welcome/install/local/

golangci-lint run go run ./cmd/service_call_guard ./app/service

openapi & swagger

swag fmt --dir server/handler swag init --parseDependency --parseDepth 1 --dir server/handler -g handler.go -o server/docs

devtools

Reset dev environment (recreate DB, apply migrations & create default user). Useful during active development when you messed with the DB or need a clean state.

go run ./cmd/cli/main.go rde
(run go run ./cmd/cli/main.go ? rde for details)

Directories ¶

Path	Synopsis
app Package app ...	Package app ...
ds Package ds (Data Structure) All data models belonging to the app are stored here.	Package ds (Data Structure) All data models belonging to the app are stored here.
ds/user_activity Package useractivity ...	Package useractivity ...
repo Package repo ...	Package repo ...
service Package service ...	Package service ...
session Package session provides primitives for managing user sessions using JSON Web Tokens (JWT).	Package session provides primitives for managing user sessions using JSON Web Tokens (JWT).
cli Package cli provides a lightweight CLI framework with support for positional arguments, named parameters, and flags.	Package cli provides a lightweight CLI framework with support for positional arguments, named parameters, and flags.
cmd
cli command Package main ...	Package main ...
cli/commands Package commands ...	Package commands ...
new_db_migration command New DB migration.	New DB migration.
server command Package main ...	Package main ...
service_call_guard command Package main implements a custom analyzer that checks for the usage of the 'call' wrapper in public methods of the Service struct, ensuring consistent validation via 'Normalize'.	Package main implements a custom analyzer that checks for the usage of the 'call' wrapper in public methods of the Service struct, ensuring consistent validation via 'Normalize'.
email Package email ...	Package email ...
frontend Package frontend handles the application's user-facing elements, such as serving static files and rendering HTML templates	Package frontend handles the application's user-facing elements, such as serving static files and rendering HTML templates
component templ: version: v0.3.960	templ: version: v0.3.960
layout templ: version: v0.3.960	templ: version: v0.3.960
page templ: version: v0.3.960	templ: version: v0.3.960
oauth
provider Package provider manages OAuth identity provider types and their validation.	Package provider manages OAuth identity provider types and their validation.
server Package server ...	Package server ...
docs Package docs Code generated by swaggo/swag.	Package docs Code generated by swaggo/swag.
endpoint Package endpoint ...	Package endpoint ...
handler Package handler contains HTTP handlers for the app's API endpoints.	Package handler contains HTTP handlers for the app's API endpoints.
middleware Package middleware ...	Package middleware ...
request Package request ...	Package request ...
response Package response provides structures and utilities for API responses.	Package response provides structures and utilities for API responses.
test Package test ...	Package test ...
factory Package factory ...	Package factory ...
factory/random Package random provides utility functions for generating various types of random data.	Package random provides utility functions for generating various types of random data.
trace Package trace ...	Package trace ...
worker Package worker ...	Package worker ...
cleanup_change_email_requests Package cleanupchangeemailrequests ...	Package cleanupchangeemailrequests ...
cleanup_deleted_users Package cleanupdeletedusers ...	Package cleanupdeletedusers ...
cleanup_expired_password_change_requests Package cleanupexpiredpasswordchangerequests ...	Package cleanupexpiredpasswordchangerequests ...
cleanup_expired_user_sessions Package cleanupexpiredusersessions ...	Package cleanupexpiredusersessions ...
delete_unconfirmed_users Package deleteunconfirmedusers ...	Package deleteunconfirmedusers ...

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL