💻 Фреймворк, где файловая система это карта маршрутов

Связка Go и HTMX хорошо стартует, но со временем почти каждый проект обрастает одним и тем же обвесом. Диспетчер маршрутов, стек лейаутов, безопасные URL, проверки на устаревшую генерацию, отпечатки ассетов, команды для отладки.

Без общего фреймворка каждое приложение изобретает свою приватную конвенцию роутинга и растаскивает строковые пути по хендлерам, шаблонам, редиректам и тестам.

goldr стандартизирует этот слой и при этом оставляет приложение явным.

➡️ Что делает goldr

goldr это server-first, HTML-first, HTMX-native фреймворк на Go. Он не вытаскивает центр тяжести из Go. Файловая система становится картой маршрутов,

.templ файлы владеют HTML, HTMX остаётся видимым прямо в разметке, хендлеры остаются обычным Go, а сгенерированный код берёт на себя повторяющуюся работу вокруг маршрутов.

Вы получаете полный рабочий цикл приложения на Go и HTMX. Это маршрутные страницы, вложенные лейауты, HTMX-фрагменты, экшены на мутации, сгенерированные хелперы для URL, live reload, отпечатанные и встроенные статические ресурсы, команды инспекции маршрутов и визуальный инспектор в браузере, который умеет подсвечивать области отрендеренной страницы.

При этом приложение по-прежнему владеет своим net/http сервером, миддлварями, статикой, авторизацией, сессиями, парсингом запросов, валидацией и деплоем. goldr не компилирует CSS, не бандлит JavaScript, не регистрирует хендлеры за вас и не выбирает CDN.

➡️ Как устроены маршруты

В goldr файловая система и есть карта маршрутов. Директория маршрута это единица локального поведения:

app/routes/
  layout.go          -> логика лейаута для / и ниже
  layout.templ       -> HTML лейаута
  route.go           -> GET /
  page.templ         -> HTML страницы
  users/
    route.go         -> GET /users, GET /users/table, POST /users/create
    page.templ       -> HTML страницы users
    by_id/
      route.go       -> GET /users/{id}
      page.templ     -> HTML детальной страницы
    frag_table.templ -> HTML фрагмента

Один route.go объявляет страницу, HTMX-фрагменты и POST-экшены для этой части приложения:

var Route = goldr.RouteDef{
  Page: page,
  Fragments: goldr.Fragments{
    goldr.FragmentRoute("/table", table),
  },
  Actions: goldr.Actions{
    goldr.Action(http.MethodPost, "/create", postCreate),
  },
}

Из файловой системы и этих объявлений goldr генерирует диспатч и типобезопасные хелперы URL. Вместо захардкоженных путей шаблоны ссылаются на сгенерированные хелперы:

urls.Users.Path()
urls.Users.Table.Path()
urls.Users.Create.Path()
urls.Users.ByID.Bind(id).Path()

Важно, что HTMX остаётся видимым на месте вызова. Сгенерированный путь фрагмента подставляется прямо в атрибут hx-get, а не прячется за проприетарными компонентами:

templ UsersView() {
  <button
    hx-get={ urls.Users.Table.Path() }
    hx-target="#users-table"
    hx-swap="innerHTML"
  >
    Refresh users
  </button>
  <div id="users-table"></div>
}

Директория by_id/ маппится в динамический сегмент {id}. Подчёркивания в статических именах превращаются в дефисы в URL, поэтому Go-безопасное имя build_info/ отдаёт путь /build-info.

➡️ Команды разработки

goldr dev держит локальный цикл в движении. Он генерирует templ и маршруты, отпечатывает ассеты, перезапускает приложение и перезагружает браузер. goldr generate обновляет обвязку маршрутов, хелперы URL, вывод templ и отпечатки ассетов одной командой. goldr check проверяет, что сгенерированные файлы актуальны, ничего при этом не записывая.

Команды routes list, routes explain и routes layouts показывают дерево маршрутов из терминала, а routes refs собирает прямые HTMX-ссылки из .templ файлов.

Если у вас растёт Go-приложение с HTMX, которое должно оставаться читаемым, goldr стоит посмотреть.

➡️ Репозиторий

Иногда маршруты ведут сюда.

📍 Навигация: Вакансии • Задачи • Собесы

🐸 Библиотека Go-разработчика

#GoToProduction