Well known

Options

atProto string

security object

trust object

webfinger object

gpc object

migratePWA string string[]

matrix object

Description

This plugin makes it easier to generate some .well_known URLs. Since Lume is a static page generator, this plugin is limited to the specs that can be implemented statically and doesn't require dynamic server-side behaviours. In this first version, the implemented standards are:

• atProto handle
• security.txt
• trust.txt
• webfinger, (it only supports a single fixed subject, not dynamic ?resource= lookups)
• gpc
• PWA origin migration
• matrix

Installation

Import this plugin in your _config.ts file to use it and pass the desired data:

import lume from "lume/mod.ts";
import wellKnown from "lume/plugins/well_known.ts";

const site = lume();

site.use(wellKnown({
  gpc: {
    gpc: true,
    lastUpdate: Temporal.PlainDate.from("2026-07-01"),
  },
  atProto: "did:plc:lqbfqodxim3n27heuou7do3g",
  trust: {
    contact: "mailto:oom@oscarotero.com",
    social: "https://fosstodon.org/@lume",
    dataTrainingAllowed: false,
  },
}));

export default site;