GoLazy Guides

Feature Map

Updated

The GoLazy guides are ordered like a working book. Start with the hot path: install the CLI, create a conventional app, understand the app shape, add one route, render a view, work with assets, and test the result. Then branch into databases, browser interaction, background jobs, mailers, storage, and deployment when the application needs those capabilities.

Start here

Read these chapters first when you are learning GoLazy:

  1. QuickStart installs lazy, creates an app, and starts the development loop.
  2. What's A Lazy App? shows the smallest complete app and explains why real apps use the normal directory layout.
  3. App Structure introduces the generated layout, then Application Structure expands the ownership model.
  4. First Route, Controller, And View makes the first application change.
  5. Basic Routes, Controller Architecture, and Views And Layouts explain the main request path.
  6. Embedded Assets, Testing, and Build One Binary take the app from local development toward a deployable binary.

Expand when needed

Use Databases Overview when the app needs persistent state. Use Extras Overview when it needs richer browser interaction, background jobs, mailers, stored files, or generated media. Use AI Overview when the app needs agent guidance, default skills, authentication for dependent clients, or an MCP server. Use Deployment Checklist when the binary is ready to run outside development.

The Changelog and Upgrade Guide are release references at the end of the guide set. New applications can read them later; existing applications should read them before moving to a newer GoLazy version.

01

Development

  1. 01 QuickStart
  2. 02 Development
  3. 03 Mise
  4. 04 Lazy
  5. 05 Development Panel
  6. 06 Lazydev Mode
  7. 07 Services
  8. 08 Datasets
02

Lazy App

  1. 01 What's A Lazy App?
  2. 02 App Structure
  3. 03 First Route, Controller, And View
  4. 04 Application Structure
  5. 05 Application Startup
  6. 06 Context And Services
  7. 07 Configuration And Secrets
03

Routing

  1. 01 Basic Routes
  2. 02 HandlerFunc Routes
  3. 03 Controller Routes
  4. 04 REST Resources
  5. 05 Namespaces
  6. 06 Middleware
04

Controllers

  1. 01 Controller Architecture
  2. 02 Actions
  3. 03 Generator Arguments
  4. 04 Formats And MIME
  5. 05 Redirects, Metadata, And Errors
  6. 06 Server-Sent Events
05

Views

  1. 01 Views And Layouts
  2. 02 Template Data And Helpers
  3. 03 Caching
  4. 04 SEO And Sitemaps
  5. 05 Forms
  6. 06 Namespaced Views
  7. 07 Escaping And Trusted HTML
06

Assets

  1. 01 Embedded Assets
  2. 02 Hashing And Fingerprints
  3. 03 Stylesheets And Tailwind
  4. 04 app/js Modules
  5. 05 Stimulus And Turbo Imports
  6. 06 lazy js And js.toml
  7. 07 lazy Dev Loop Integration
07

Testing

  1. 01 Testing Overview
  2. 02 Route Tests
  3. 03 Controller Tests
  4. 04 Rendering Tests
  5. 05 Asset Tests
  6. 06 Integration Tests
08

Databases

  1. 01 Databases Overview
  2. 02 Migrations
  3. 03 PostgreSQL
09

Extra guides

  1. 01 Extras Overview
  2. 02 Hotwire Turbo
  3. 03 Turbo Frames
  4. 04 Stimulus Controllers
  5. 05 Server-Rendered Updates
  6. 06 PWA, Workers And Notifications
  7. 07 WebSockets
  8. 08 Background Jobs
  9. 09 Mailers
  10. 10 Storage, Assets, And Media
10

AI

  1. 01 AI Overview
  2. 02 Authentication And OAuth
  3. 03 AI Project Guidance
  4. 04 Default Skills
  5. 05 MCP Server
11

Build And Deploy

  1. 01 Build One Binary
  2. 02 Native Desktop
  3. 03 Generated Assets Before Build
  4. 04 Unpack Assets
  5. 05 Address Configuration
  6. 06 Control Plane
  7. 07 Telemetry
  8. 08 Deployment Checklist
  9. 09 Changelog
  10. 10 Upgrade Guide