README
¶
lagodev examples
Pick the one that matches your stack — each runs standalone with
go mod tidy && go run ..
| Folder | What it shows |
|---|---|
basic/ |
The 30-line tour: connection → migrations → ORM → query |
blog/ |
Full showcase — 3 models, FK, factories, seeders, service |
gin/ |
Gin v1 server wrapping a framework-agnostic service |
fiber/ |
Fiber v2 — identical service, swapped HTTP layer |
echo/ |
Echo v4 — same |
chi/ |
Chi v5 — Go-native routing on top of net/http |
microservice/ |
A queue-style worker with LockForUpdate + tx |
grpc/ |
A bare-bones gRPC service that shares the ORM with HTTP |
The pattern
Every example follows the same shape:
1. Define models (embed orm.Model)
2. Register migrations in init()
3. Apply migrations at startup
4. Build a *Service struct that takes a *database.Connection
5. Wrap the service in framework-specific handlers
The *Service layer is the integration point — it returns plain Go
values and errors. That's why swapping Gin → Fiber → Echo means changing
only the HTTP wiring, never the business logic.
See also
../docs/GETTING_STARTED.md— first 10 minutes../docs/CLI.md— fulllago/artisanreference../docs/ORM.md— ORM cookbook../docs/MIGRATIONS.md— migration patterns../docs/FACTORIES.md— factories + seeders../docs/CONFIGURATION.md—.envandlago.json../docs/FRAMEWORK_INTEGRATION.md— Gin/Fiber/Echo/Chi/gRPC patterns../docs/ARCHITECTURE.md— how it all fits together
Directories
¶
| Path | Synopsis |
|---|---|
|
Example: end-to-end usage of lagodev with an in-memory SQLite database.
|
Example: end-to-end usage of lagodev with an in-memory SQLite database. |
|
Example: a microservice-style worker that reads jobs from a queue table.
|
Example: a microservice-style worker that reads jobs from a queue table. |
|
Example: secure-by-default lagodev HTTP service.
|
Example: secure-by-default lagodev HTTP service. |
Click to show internal directories.
Click to hide internal directories.