front

package

v0.21.1 Latest Latest Go to latest Published: Feb 15, 2026 License: Apache-2.0 Imports: 34 Imported by: 0

Details

Valid go.mod file
Redistributable license
Tagged version
Stable version
Learn more about best practices

Repository

github.com/dimkr/tootik

Links

Open Source Insights

README ¶

Frontend

Gemini Frontend

/local shows a compact list of local posts; each entry contains a link to /view.
/ is the homepage: it shows an ASCII art logo, a short description of this server and a list of local posts.
/hashtag shows a compact list of posts with a given hashtag.
/search shows an input prompt and redirects to /hashtag.
/hashtags shows a list of popular hashtags.
/fts shows an input prompt and performs full-text search in posts.
/status shows statistics and server health metrics.
/view shows a complete post with extra details like links in the post, a list mentioned users, a list of hashtags, a link to the author's outbox, a list of replies and a link to the parent post (if found).
/outbox shows list of posts by a user.

Users are authenticated using TLS client certificates; see Gemini protocol specification for more details. The following pages require authentication:

/users shows posts by followed users, sorted chronologically.
/users/mentions is like /users but shows only posts that mention the user.
/users/register creates a new user.
/users/follows shows a list of followed users, ordered by activity.
/users/me redirects the user to their outbox.
/users/resolve looks up federated user user@domain or local user user.
/users/dm creates a post visible to mentioned users.
/users/whisper creates a post visible to followers.
/users/say creates a public post.
/users/reply replies to a post.
/users/edit edits a post.
/users/delete deletes a post.
/users/share shares a post.
/users/unshare removes a shared post.
/users/follow sends a follow request to a user.
/users/unfollow deletes a follow request.
/users/outbox is equivalent to /outbox but also includes a link to /users/follow or /users/unfollow.
/users/bio allows users to edit their bio.
/users/name allows users to set their display name.
/users/alias allows users to set an account alias, to allow migration of accounts to tootik.
/users/move allows users to notify followers of account migration from tootik.

Some clients generate a certificate for / (all pages of this capsule) when /foo requests a client certificate, while others use the certificate requested by /foo only for /foo and /foo/bar. Therefore, pages that don't require authentication are also mirrored under /users:

/users/local
/users/hashtag
/users/hashtags
/users/fts
/users/status
/users/view

This way, users who prefer not to provide a client certificate when browsing to /x can reply to public posts by using /users/x instead.

To make the transition to authenticated pages more seamless, links in the user menu at the bottom of each page point to /users/x rather than /x, if the user is authenticated.

All pages follow the subscription convention, so users can "subscribe" to a user, a hashtag, posts by followed users or other activity. This way, tootik can act as a personal fediverse aggregator. In addition, feeds like /users have separators between days, to interrupt the endless stream of incoming content, make the content consumption more intentional and prevent doomscrolling.

Authentication

If no client certificate is provided, all pages under /users redirect the client to /users.

/users asks the client to provide a certificate. Well-behaved clients should generate a certificate, re-request /users, then reuse this certificate in future requests of /users and pages under it.

If a certificate is provided but does not belong to any user, the client is redirected to /users/register.

By default, the username associated with a client certificate is the common name specified in the certificate. If invalid or already in use by another user, /users/register asks the user to provide a different username. Once the user is registered, the client is redirected back to /users.

Once the client certificate is associated with a user, all pages under /users look up the authenticated user's data using the certificate hash.

Posts

tootik has three kinds of posts:

To mentioned users: posts visible to mentioned users only
Posts: posts visible to followers of a user
Public posts: posts visible to anyone

Post Visibility

Post type	To	CC
To mentioned users	-	Mentions
To followers	Author's followers	Mentions
To public	Public	Mentions and author's followers

Reply Visibility

Post type	To	CC
Public in To	Post author and Public	Followers of reply author
Public in CC	Post author	Followers of reply author and Public
Everything else	Post author	Post audience

Post Editing

/users/edit cannot remove recipients from the post audience, only add more. If a post that mentions only @a is edited to mention only @b, both a and b will receive the updated post.

Polls

tootik supports Station-style polls. To publish a poll, publish a post in the form:

[POLL post content] option 1 | option 2 | ...

For example:

[POLL Does #tootik support polls now?] Yes | No | I don't know

Polls are multi-choice, allowed to have 2 to 5 options and end after a month.

Poll results are updated every 30m and distributed to other servers if needed.

Documentation ¶

Overview ¶

Package front implements a UI and exposes it over text-based protocols.

Index ¶

Variables
type Handler
- func NewHandler(domain string, cfg *cfg.Config, resolver ap.Resolver, db *sql.DB, ...) (Handler, error)
- func (h *Handler) Handle(r *Request, w text.Writer)
- func (h *Handler) PrintNotes(w text.Writer, r *Request, rows *sql.Rows, ...) int
type Request

Constants ¶

This section is empty.

Variables ¶

View Source

var (
	ErrNotRegistered = errors.New("user is not registered")
	ErrNotInvited    = errors.New("user was not invited")
	ErrNotApproved   = errors.New("client certificate is not approved")
)

Functions ¶

This section is empty.

Types ¶

type Handler ¶

type Handler struct {
	Domain   string
	Config   *cfg.Config
	Resolver ap.Resolver
	DB       *sql.DB
	Inbox    ap.Inbox
	// contains filtered or unexported fields
}

Handler handles frontend (client-to-server) requests.

func NewHandler ¶

func NewHandler(domain string, cfg *cfg.Config, resolver ap.Resolver, db *sql.DB, inbox ap.Inbox) (Handler, error)

NewHandler returns a new Handler.

func (*Handler) Handle ¶

func (h *Handler) Handle(r *Request, w text.Writer)

Handle handles a request and writes a response.

func (*Handler) PrintNotes ¶

func (h *Handler) PrintNotes(w text.Writer, r *Request, rows *sql.Rows, printParentAuthor, printDaySeparators bool, fallback string) int

type Request ¶

type Request struct {
	// Context specifies the request context.
	Context context.Context

	// URL specifies the requested URL.
	URL *url.URL

	// Log specifies a slog.Logger used while handling the request.
	Log *slog.Logger

	// Body optionally specifies an io.Reader to read the request body from.
	Body io.Reader

	// User optionally specifies a signed in user.
	User *ap.Actor

	// Keys optionally specifies the signing keys associated with User.
	Keys [2]httpsig.Key
}

Request represents a request.

Directories ¶

Path	Synopsis
gemini Package gemini exposes a Gemini interface.	Package gemini exposes a Gemini interface.
graph Package graph draws text-based graphs.	Package graph draws text-based graphs.
static Package static serves static content.	Package static serves static content.
text Package text is an abstraction layer for different text formats.	Package text is an abstraction layer for different text formats.
gmi Package gmi build Gemini responses.	Package gmi build Gemini responses.
plain Package plain converts HTML to plain text and vice versa.	Package plain converts HTML to plain text and vice versa.
user Package user handles user registration.	Package user handles user registration.

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL