Layouts and Routes

src/routes/notes/[slug]/+page.wisp

---
let Some(note) = notes::find(&slug) else {
    return error(404, "There is no such note.");
};
---

<title>${note.title}</title>
<h1>${note.title}</h1>
<p>${note.body}</p>

src/routes/notes/+layout.wisp

<div class="notes">
  <nav aria-label="Notes">
    {#each notes::NOTES.iter() as n}
      <a href=${routes::notes_slug(n.slug)}>${n.title}</a>
    {/each}
  </nav>
  <div>
    <slot />
  </div>
</div>

<style>
  .notes {
    display: grid;
    grid-template-columns: 10rem 1fr;
    gap: 1.25rem;
  }

  nav {
    display: grid;
    align-content: start;
    gap: 0.5rem;
    font-size: 0.875rem;
  }
</style>

src/routes/notes/+page.wisp

<title>Notes</title>
<h1>Notes</h1>
<p class="muted">Pick a note.</p>

src/routes/+error.wisp

<title>${status}</title>
<h1>${status}</h1>
<p>${message}</p>
<p><a href="/notes">Back to the notes</a></p>

src/routes/+layout.wisp

<header class="top">
  <a href="/">Home</a>
  <a href="/notes">Notes</a>
</header>
<main>
  <slot />
</main>

<style>
  .top {
    display: flex;
    gap: 1rem;
    margin-bottom: 1.25rem;
    padding-bottom: 0.75rem;
    border-bottom: 1px solid var(--line);
    font-weight: 600;
  }
</style>

src/routes/+page.wisp

<title>Home</title>
<h1>Home</h1>
<p>This app has a home page, a notes section with a layout of its own, and a page for each note.</p>
<p><a href=${routes::notes_slug("files")}>Start with the first note</a>.</p>

src/app.css

/* One small stylesheet for every example: light or dark with the system,
   violet accent, neutrals tinted toward it. */
:root {
  color-scheme: light dark;
  --bg: light-dark(oklch(0.99 0.004 295), oklch(0.2 0.014 290));
  --panel: light-dark(oklch(1 0 0), oklch(0.24 0.016 290));
  --sunk: light-dark(oklch(0.965 0.008 295), oklch(0.17 0.012 290));
  --line: light-dark(oklch(0.9 0.012 295), oklch(0.34 0.02 290));
  --ink: light-dark(oklch(0.22 0.02 290), oklch(0.96 0.006 295));
  --muted: light-dark(oklch(0.48 0.02 290), oklch(0.76 0.016 290));
  --accent: light-dark(oklch(0.5 0.21 290), oklch(0.72 0.15 292));
  --accent-strong: light-dark(oklch(0.43 0.2 290), oklch(0.8 0.12 292));
  --accent-soft: light-dark(oklch(0.95 0.03 295), oklch(0.3 0.06 290));
  --on-accent: light-dark(oklch(1 0 0), oklch(0.18 0.02 290));
  --warn: light-dark(oklch(0.52 0.17 40), oklch(0.78 0.12 50));
  --radius: 0.5rem;
  --space: 1rem;
  --mono: ui-monospace, "Cascadia Code", Menlo, monospace;
}

:root[data-theme="light"] {
  color-scheme: light;
}

:root[data-theme="dark"] {
  color-scheme: dark;
}

* {
  box-sizing: border-box;
}

body {
  max-width: 40rem;
  margin: 0 auto;
  padding: 1.5rem 1rem 3rem;
  background: var(--bg);
  color: var(--ink);
  font: 400 1rem/1.6 system-ui, -apple-system, "Segoe UI", sans-serif;
  -webkit-font-smoothing: antialiased;
}

/* Type */

h1 {
  margin: 0 0 1rem;
  font-size: clamp(1.5rem, 1.2rem + 1.5vw, 1.875rem);
  line-height: 1.15;
  letter-spacing: -0.02em;
  text-wrap: balance;
}

h2 {
  margin: 2rem 0 0.75rem;
  font-size: 1.125rem;
  letter-spacing: -0.01em;
}

h3 {
  margin: 0 0 0.5rem;
  font-size: 1rem;
}

p {
  margin: 0 0 var(--space);
}

a {
  color: var(--accent);
  text-underline-offset: 0.2em;
}

a:hover {
  color: var(--accent-strong);
}

:focus-visible {
  outline: 2px solid var(--accent);
  outline-offset: 2px;
}

code {
  padding: 0.1em 0.35em;
  border-radius: 0.3em;
  background: var(--sunk);
  font: 0.875em var(--mono);
}

pre {
  margin: 0 0 var(--space);
  padding: 0.875rem 1rem;
  overflow-x: auto;
  border: 1px solid var(--line);
  border-radius: var(--radius);
  background: var(--sunk);
  font: 0.875rem/1.55 var(--mono);
}

pre code {
  padding: 0;
  background: none;
}

.muted {
  color: var(--muted);
}

/* Nav between routes: a header of links, the current one marked. */

header,
nav {
  display: flex;
  flex-wrap: wrap;
  gap: 0.25rem 1.25rem;
  margin: 0 0 1.5rem;
  padding: 0 0 0.75rem;
  border-bottom: 1px solid var(--line);
  font-weight: 600;
}

header a,
nav a {
  color: var(--muted);
  text-decoration: none;
}

header a:hover,
nav a:hover,
header a[aria-current],
nav a[aria-current] {
  color: var(--ink);
}

/* Forms: fields stack their label above, the button sits at the end of the row. */

form {
  display: flex;
  flex-wrap: wrap;
  align-items: end;
  gap: 1rem 0.75rem;
  margin: 0 0 1.75rem;
}

/* A lone button with an action is a form of its own: it sits in the line. */
form:has(> button:only-child) {
  display: inline-flex;
  margin: 0;
}

label {
  position: relative;
  display: grid;
  flex: 1 1 12rem;
  gap: 0.375rem;
  color: var(--muted);
  font-size: 0.875rem;
  font-weight: 600;
}

label:has(> input[type="checkbox"]) {
  display: flex;
  flex: 0 0 auto;
  align-items: center;
  align-self: center;
}

input,
select,
textarea {
  width: 100%;
  min-height: 2.75rem;
  padding: 0.5rem 0.75rem;
  border: 1px solid var(--line);
  border-radius: var(--radius);
  background: var(--panel);
  color: var(--ink);
  font: inherit;
  font-size: 1rem;
  font-weight: 400;
  transition: border-color 0.15s, box-shadow 0.15s;
}

input:hover,
select:hover,
textarea:hover {
  border-color: var(--muted);
}

input:focus,
select:focus,
textarea:focus {
  border-color: var(--accent);
  outline: none;
  box-shadow: 0 0 0 3px var(--accent-soft);
}

input[type="checkbox"] {
  width: 1.125rem;
  min-height: 0;
  accent-color: var(--accent);
}

input[type="file"] {
  padding: 0.4rem;
}

[aria-invalid="true"] {
  border-color: var(--warn);
}

/* A field's problem sits right under it, so the button beside the field stays put. */
label .problem {
  position: absolute;
  top: calc(100% + 0.25rem);
}

form:has(.problem) {
  row-gap: 2.25rem;
  margin-bottom: 2.75rem;
}

.problem {
  display: block;
  color: var(--warn);
  font-size: 0.8125rem;
  font-weight: 500;
}

/* Buttons */

button,
.button {
  display: inline-flex;
  align-items: center;
  justify-content: center;
  min-height: 2.75rem;
  padding: 0 1.125rem;
  border: 1px solid var(--accent);
  border-radius: var(--radius);
  background: var(--accent);
  color: var(--on-accent);
  font: 600 0.9375rem/1 system-ui, sans-serif;
  text-decoration: none;
  white-space: nowrap;
  cursor: pointer;
  transition: background 0.15s, border-color 0.15s, transform 0.1s;
}

button:hover,
.button:hover {
  border-color: var(--accent-strong);
  background: var(--accent-strong);
  color: var(--on-accent);
}

button:active {
  transform: translateY(1px);
}

button:disabled,
button[aria-busy="true"] {
  opacity: 0.6;
  cursor: progress;
  transform: none;
}

button.quiet {
  min-height: 2.25rem;
  padding: 0 0.75rem;
  border-color: var(--line);
  background: var(--panel);
  color: var(--ink);
  font-weight: 500;
}

button.quiet:hover {
  border-color: var(--accent);
  background: var(--accent-soft);
  color: var(--ink);
}

.bar {
  display: flex;
  flex-wrap: wrap;
  align-items: center;
  justify-content: space-between;
  gap: 0.75rem;
  margin-top: 1rem;
}

/* Lists: plain ones keep their bullets; a .list is rows in a panel. */

ul,
ol {
  margin: 0 0 var(--space);
  padding-left: 1.25rem;
}

li + li {
  margin-top: 0.25rem;
}

ul.list {
  margin: 0 0 var(--space);
  padding: 0;
  overflow: hidden;
  border: 1px solid var(--line);
  border-radius: var(--radius);
  background: var(--panel);
  list-style: none;
}

label + ul.list {
  margin-top: 0.75rem;
}

ul.list li {
  display: flex;
  flex-wrap: wrap;
  align-items: center;
  justify-content: space-between;
  gap: 0.5rem 0.75rem;
  margin: 0;
  padding: 0.625rem 0.75rem 0.625rem 1rem;
}

ul.list li + li {
  border-top: 1px solid var(--line);
}

/* An empty list says so, quietly, in the middle. */
ul.list li.muted:only-child {
  justify-content: center;
  padding: 1.5rem 1rem;
  background: var(--sunk);
}

/* Tables */

table {
  width: 100%;
  margin: 0 0 var(--space);
  border-collapse: collapse;
  font-size: 0.9375rem;
}

th,
td {
  padding: 0.5rem 0.75rem;
  border-bottom: 1px solid var(--line);
  text-align: left;
}

th {
  color: var(--muted);
  font-size: 0.8125rem;
  font-weight: 600;
}

hr {
  margin: 1.5rem 0;
  border: 0;
  border-top: 1px solid var(--line);
}

@media (prefers-reduced-motion: reduce) {
  * {
    transition: none !important;
    animation: none !important;
  }
}

src/app.html

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <meta name="viewport" content="width=device-width, initial-scale=1">
  %wisp.head%
</head>
<body>
  %wisp.body%
</body>
</html>

src/notes.rs

pub struct Note {
    pub slug: &'static str,
    pub title: &'static str,
    pub body: &'static str,
}

pub const NOTES: [Note; 3] = [
    Note { slug: "files", title: "Files Are Routes", body: "A folder under src/routes is an address, and the +page.wisp inside it is the page." },
    Note { slug: "layouts", title: "Layouts Wrap Pages", body: "A +layout.wisp wraps every page below its folder. Layouts nest." },
    Note { slug: "params", title: "Brackets Are Params", body: "A folder named [slug] matches any one segment and hands it to the page." },
];

pub fn find(slug: &str) -> Option<&'static Note> {
    NOTES.iter().find(|n| n.slug == slug)
}