a-h/templ

★ 10,299GoAudience · developerComplexity · 3/5Setup · moderate

Mindmap

mindmap
  root((templ))
    What it does
      Type-safe HTML
      Compile-time checking
      Go code generation
    Developer tooling
      LSP support
      Editor autocomplete
      Built-in formatter
    Common patterns
      HTMX integration
      Server-side rendering
      Reusable components
    Workflow
      Write .templ files
      Compile to Go
      Serve requests

mindmap root((templ)) What it does Type-safe HTML Compile-time checking Go code generation Developer tooling LSP support Editor autocomplete Built-in formatter Common patterns HTMX integration Server-side rendering Reusable components Workflow Write .templ files Compile to Go Serve requests

Click or tap to explore — scroll the page freely

Things people build with this

USE CASE 1

Build server-rendered web UIs in Go where the compiler catches typos in HTML component code.

USE CASE 2

Use HTMX with Go to add interactive page updates without writing any JavaScript.

USE CASE 3

Get autocomplete and error highlighting for HTML templates inside VS Code or Neovim.

USE CASE 4

Generate consistent, type-safe HTML from reusable Go components across a large codebase.

Tech stack

GoHTMLLSP

Getting it running

Difficulty · moderate Time to first run · 30min

Requires the templ CLI in addition to Go, full editor support needs LSP configuration per editor.

In plain English

Templ is a templating language for Go that lets developers write HTML component definitions directly in Go files, with full type safety and editor support. Instead of writing HTML in separate string-based template files where typos only show up at runtime, templ lets you define HTML components in a syntax that the compiler can check, catching errors before the code runs. The project ships a command-line tool that compiles .templ files into standard Go code. This generated Go code is what actually runs on your server, meaning the templates have no runtime dependency on a template engine at the point of serving requests. The CLI also includes a formatter to keep templ files consistently styled. Developer tooling is a focus of the project. Templ provides a Language Server Protocol (LSP) implementation, which means editors like VS Code, Neovim, or any other LSP-compatible editor can offer autocomplete, error highlighting, and go-to-definition inside .templ files the same way they do for regular Go code. The project README includes a GIF showing this IDE integration in action. Templ is commonly used with HTMX, a library that adds interactivity to HTML by making server-round-trips on user actions. The combination is a pattern for building web UIs with Go on the server without writing JavaScript. Documentation and guides live at the templ.guide website. The README for this repository is primarily a list of developer build tasks for contributors working on templ itself (building, testing, formatting, releasing), rather than a user introduction. Full user documentation is at the external docs site.

Copy-paste prompts

Prompt 1

I'm building a Go HTTP server and want to use templ. Show me how to create a component that renders a user card with a name and email, then call it from an HTTP handler.

Prompt 2

Set up templ in a new Go project, install the VS Code extension, and configure the LSP so I get autocomplete inside .templ files.

Prompt 3

Show me a pattern for using templ with HTMX so a button click fetches and replaces part of the page without a full reload, all in Go with no JavaScript.

Prompt 4

How do I integrate the templ compiler and formatter into a Makefile so .templ files are automatically compiled to Go code during the build?

Open on GitHub → Explain another repo

← a-h on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.