README.md

October 30, 2025 ยท View on GitHub

Release Discord Test

Ace is a template engine create by yossi, to see the original syntax documentation please click here

Installation

Go version support: We only support the latest two versions of Go. Visit https://go.dev/doc/devel/release for more information.

go get github.com/gofiber/template/ace/v3

Basic Example

./views/index.ace

= include ./views/partials/header .

h1 {{.Title}}

= include ./views/partials/footer .

./views/partials/header.ace

h1 Header

./views/partials/footer.ace

h1 Footer

./views/layouts/main.ace

= doctype html
html
  head
    title Main
  body
    {{embed}}
package main

import (
	"log"
	
	"github.com/gofiber/fiber/v3"
	"github.com/gofiber/template/ace/v3"
)

func main() {
	// Create a new engine
	engine := ace.New("./views", ".ace")

  // Or from an embedded system
  // See github.com/gofiber/embed for examples
  // engine := html.NewFileSystem(http.Dir("./views", ".ace"))

	// Pass the engine to the Views
	app := fiber.New(fiber.Config{
		Views: engine,
	})

	app.Get("/", func(c fiber.Ctx) error {
		// Render index
		return c.Render("index", fiber.Map{
			"Title": "Hello, World!",
		})
	})

	app.Get("/layout", func(c fiber.Ctx) error {
		// Render index within layouts/main
		return c.Render("index", fiber.Map{
			"Title": "Hello, World!",
		}, "layouts/main")
	})

	log.Fatal(app.Listen(":3000"))
}