Routes

You can add a new route to the server with AddRoute().

package main

import (
  "embed"
  frz "github.com/razshare/frizzante"
  "main/lib/handlers"
)

//go:embed .dist/*/**
var dist embed.FS

func main() {
    frz.NewServer().
        WithDist(dist).
        AddRoute(frz.Route{Pattern: "GET /", Handler: handlers.GetHello}).
        Start()
}

lib/handlers/hello.go

package handlers

import frz "github.com/razshare/frizzante"

func GetHello(c *frz.Connection) {
    c.SendMessage("Hello")
}

Status

Use c.SendStatus() to send the status of the response.

lib/handlers/hello.go

package handlers

import frz "github.com/razshare/frizzante"

func GetHello(c *frz.Connection) {
    c.SendStatus(404)                             // Sends status 404.
    c.SendMessage("Resource not found, sorry.")   // Sends text.
}

Danger

The order in which data is sent to the client matters.
Read more about order of operations.

Header

Use c.ReceiveHeader() to retrieve header fields and c.SendHeader() to send them.

lib/handlers/hello.go

package handlers

import frz "github.com/razshare/frizzante"

func GetHello(c *frz.Connection) {
    ctype := c.ReceiveHeader("Accept")      // Retrieves field "Accept".
    c.SendHeader("Content-Type", ctype)     // Sends it back.
}

Danger

The order in which data is sent to the client matters.
Read more about order of operations.

Path

Request handlers can define dynamic fields within the pattern using {} syntax.

Path fields can then be retrieved with c.ReceivePath().

Handler

lib/handlers/hello.go

package handlers

import frz "github.com/razshare/frizzante"

func GetHello(c *frz.Connection) {
    name := c.ReceivePath("name")     // Retrieves field "name".
    c.SendMessage("Hello " + name)    // Sends text.
}

Pattern

GET /{name}

Query

Use c.ReceiveQuery() to retrieve query fields.

lib/handlers/hello.go

package handlers

import frz "github.com/razshare/frizzante"

func GetHello(c *frz.Connection) {
    name := c.ReceiveQuery("name")    // Retrieves field "name".
    c.SendMessage("Hello " + name)    // Sends text.
}

Forms

Use c.ReceiveForm() to retrieve and parse forms when using POST and PUT http verbs.

lib/handlers/hello.go

package handlers

import frz "github.com/razshare/frizzante"

func PostHello(c *frz.Connection) {
    form := c.ReceiveForm()         // Retrieves and parses the form.
    name := form.Get("name")        // Retrieves field "name".
    c.SendMessage("Hello " + name)  // Sends text.
}

Json

Use c.ReceiveJson() to parse incoming content as json and c.SendJson() to send data as json when using POST and PUT http verbs.

lib/handlers/hello.go

package handlers

import frz "github.com/razshare/frizzante"

type GreetingDetails struct {
    Name string `json:"name"`
}

func PostHello(c *frz.Connection) {
    var value *GreetingDetails  // Prepares empty value.
    c.ReceiveJson(value)        // Parses the content into value.
    c.SendJson(value)           // Sends it back.
}

Cookies

Use c.ReceiveCookie() to retrieve cookies and c.SendCookie() to send them.

lib/handlers/hello.go

package handlers

import frz "github.com/razshare/frizzante"

func GetHello(c *frz.Connection) {
    cookie := c.ReceiveCookie("session-id")   // Retrieves cookie "session-id".
    c.SendCookie("session-id", cookie)        // Sends it back.
}

Redirect

Use c.SendRedirect() to redirect to a different location.

lib/handlers/hello.go

package handlers

import frz "github.com/razshare/frizzante"

func GetHello(c *frz.Connection) {
    c.SendRedirect("/login", 302)
}

Navigate

Use c.SendNavigate() to redirect to a different location with status 302.

lib/handlers/hello.go

package handlers

import frz "github.com/razshare/frizzante"

func GetHello(c *frz.Connection) {
    c.SendNavigate("/login")
}

Server Sent Events

Use c.SendSseUpgrade() to upgrade the connection to server sent events.

lib/handlers/hello.go

package handlers

import (
    frz "github.com/razshare/frizzante"
    "time"
)

func GetHello(c *frz.Connection) {
    alive := c.IsAlive()            // Track request status.
    ev := c.SendSseUpgrade()        // Send sse upgrade.
    for *alive {                    // Loop until request gets cancelled.
        ev("channel-1")             // Switch to event "channel-1".
        c.SendMessage("hello 1")    // Send text.
        ev("channel-2")             // Switch to event "channel-2".
        c.SendMessage("hello 2")    // Send text.
        time.Sleep(time.Second)     // Sleep for 1 second.
    }
}

Web Sockets

Use c.SendWsUpgrade() to upgrade the connection to web sockets.

lib/handlers/hello.go

package handlers

import (
    frz "github.com/razshare/frizzante"
    "time"
)

func GetHello(c *frz.Connection) {
    alive := c.IsAlive()        // Track request status.
    c.SendWsUpgrade()           // Send ws upgrade.
    for *alive {                // Loop until request gets cancelled.
        c.SendMessage("hello")  // Send text.
        time.Sleep(time.Second) // Sleep for 1 second.
    }
}

Order of Operations

Order of operations matters when sending data to the client.

Status codes and headers cannot be modified after sending out content.

Danger

For example, sending the status code with c.SendStatus() after you’ve already sent content with c.SendMessage() is not allowed.

lib/handlers/hello.go

package handlers

import frz "github.com/razshare/frizzante"

func GetHello(c *frz.Connection) {
    c.SendMessage("Hello.")   // Sending text.    (Will Succeed)
    c.SendStatus(404)         // Sending status.  (Will Fail)
}

c.SendStatus(404) will fail and the user will receive status 200 instead of 404.

HTTP/1.1 200 OK
Date: Sun, 25 May 2025 02:00:37 GMT
Content-Length: 6
Content-Type: text/plain; charset=utf-8

Hello.

The failure is notified to the server notifier.

Assuming you’re using the default notifier, you’ll see an error of sorts in your console

listening for requests at http://127.0.0.1:8080
status is locked

status is locked, meaning the status code has already been sent to the client and there’s nothing you can do about it.