Login to Lucia Demo

Click the button below to log in:

\n \n Log in\n \n

Or copy and paste this URL into your browser:

${magicLink}

This link will expire in 15 minutes.

\n `,\n });\n\n return true;\n } catch (error) {\n console.error(\"Error sending email:\", error);\n return false;\n }\n}\n\n// Validate a magic link token and create a session\nexport async function validateMagicLinkToken(token: string): Promise<{ valid: boolean; userId?: number }> {\n const now = Math.floor(Date.now() / 1000);\n const tokenHash = hashToken(token);\n\n // Get the token from the database using its hash\n const { rows } = await sqlite.execute(\n `SELECT email, expires_at FROM ${MAGIC_LINKS_TABLE} WHERE id = ?`,\n [tokenHash],\n );\n\n if (rows.length === 0) {\n console.log(\"Did not find magic link token in database\");\n return { valid: false };\n }\n\n const { email, expiresAt } = rows[0];\n\n // Check if the token has expired\n if (now > expiresAt) {\n console.log(\"Magic link token has expired\", expiresAt);\n // Delete expired token\n await sqlite.execute(`DELETE FROM ${MAGIC_LINKS_TABLE} WHERE id = ?`, [tokenHash]);\n return { valid: false };\n }\n\n console.log(\"Valid magic link token\");\n\n // Get or create the user\n const { rows: userRows } = await sqlite.execute(\n `SELECT id FROM ${USER_TABLE} WHERE email = ?`,\n [email],\n );\n\n let userId: number;\n\n if (userRows.length === 0) {\n console.log(\"Creating user\", email);\n // Create a new user\n const { lastInsertRowid } = await sqlite.execute(\n `INSERT INTO ${USER_TABLE} (email, created_at) VALUES (?, ?)`,\n [email, now],\n );\n userId = lastInsertRowid;\n } else {\n console.log(\"Found user\", email);\n userId = userRows[0][0];\n }\n\n // Delete the used token\n // TODO - investigate: I found that when I immediately delete the token (single use),\n // That it causes issues. It seems like somehow the token is getting used before it's getting used.\n // Maybe my browser or something is making a pre-flight request that's using it up? Maybe my email client?\n // await sqlite.execute(`DELETE FROM ${MAGIC_LINKS_TABLE} WHERE id = ?`, [tokenHash]);\n\n return { valid: true, userId };\n}",[],[158,176,184],{"_105":194,"_98":195,"_159":196,"_161":177,"_162":142,"_163":197,"_165":121,"_107":198,"_102":199,"_167":189,"_169":200,"_170":25,"_171":-5,"_172":201,"_101":202},"679fd746-2c0d-11f0-9b08-569c3dd06744","schema.ts","e4b880f2-2b7c-11f0-a53a-569c3dd06744",106,["D",1746709653307],9,"import { sqlite } from \"https://esm.town/v/stevekrouse/sqlite\";\n\nexport const USER_TABLE = \"lucia_demo_users\";\nexport const SESSIONS_TABLE = \"lucia_demo_sessions\";\nexport const MAGIC_LINKS_TABLE = \"lucia_demo_magic_links_v2\";\n\nasync function createTables() {\n await sqlite.execute(`\n CREATE TABLE IF NOT EXISTS ${USER_TABLE} (\n id INTEGER NOT NULL PRIMARY KEY AUTOINCREMENT,\n created_at INTEGER NOT NULL,\n email STRING UNIQUE,\n username STRING UNIQUE\n )\n `);\n await sqlite.execute(`\n CREATE TABLE IF NOT EXISTS ${SESSIONS_TABLE} (\n id TEXT NOT NULL PRIMARY KEY,\n user_id INTEGER NOT NULL REFERENCES ${USER_TABLE}(id),\n expires_at INTEGER NOT NULL\n )\n `);\n await sqlite.execute(`\n CREATE TABLE IF NOT EXISTS ${MAGIC_LINKS_TABLE} (\n id TEXT NOT NULL PRIMARY KEY,\n email TEXT NOT NULL,\n created_at INTEGER NOT NULL,\n expires_at INTEGER NOT NULL\n )\n `);\n}\n\nawait createTables();",[],[158,176,195],{"_105":204,"_98":205,"_159":206,"_161":177,"_162":142,"_163":207,"_165":121,"_107":208,"_102":209,"_167":189,"_169":210,"_170":25,"_171":-5,"_172":211,"_101":212},"54811a9e-2c17-11f0-85f0-569c3dd06744","sessions.ts","7d821622-2b7d-11f0-946f-569c3dd06744",154,["D",1746713916199],16,"import { sqlite } from \"https://esm.town/v/stevekrouse/sqlite\";\nimport { sha256 } from \"npm:@oslojs/crypto/sha2\";\nimport { encodeBase32LowerCaseNoPadding, encodeHexLowerCase } from \"npm:@oslojs/encoding\";\nimport { SESSIONS_TABLE, USER_TABLE } from \"./schema.ts\";\n\nexport function generateSessionToken(): string {\n const bytes = new Uint8Array(20);\n crypto.getRandomValues(bytes);\n const token = encodeBase32LowerCaseNoPadding(bytes);\n return token;\n}\n\nexport async function createSession(token: string, userId: number): Promise {\n const sessionId = encodeHexLowerCase(sha256(new TextEncoder().encode(token)));\n const session: Session = {\n id: sessionId,\n userId,\n expiresAt: new Date(Date.now() + 1000 * 60 * 60 * 24 * 30),\n };\n await sqlite.execute(\n `INSERT INTO ${SESSIONS_TABLE} (id, user_id, expires_at) VALUES (?, ?, ?)`,\n [session.id, session.userId, Math.floor(session.expiresAt.getTime() / 1000)],\n );\n return session;\n}\n\nexport async function validateSessionToken(token: string): Promise {\n const sessionId = encodeHexLowerCase(sha256(new TextEncoder().encode(token)));\n const { rows } = await sqlite.execute(\n `SELECT s.id, s.user_id, s.expires_at, u.id, u.email, u.username \n FROM ${SESSIONS_TABLE} s \n INNER JOIN ${USER_TABLE} u ON u.id = s.user_id \n WHERE s.id = ?`,\n [sessionId],\n );\n\n if (rows.length === 0) {\n return { session: null, user: null };\n }\n\n const row = rows[0];\n const session: Session = {\n id: row[0],\n userId: row[1],\n expiresAt: new Date(row[2] * 1000),\n };\n const user: User = {\n id: row[3],\n email: row[4],\n username: row[5],\n };\n\n if (Date.now() >= session.expiresAt.getTime()) {\n await sqlite.execute(`DELETE FROM ${SESSIONS_TABLE} WHERE id = ?`, [session.id]);\n return { session: null, user: null };\n }\n\n // If 50% of the session lifetime has passed (15 days out of 30), rotate the token\n if (Date.now() >= session.expiresAt.getTime() - 1000 * 60 * 60 * 24 * 15) {\n // Generate a new token\n const newToken = generateSessionToken();\n const newSessionId = encodeHexLowerCase(sha256(new TextEncoder().encode(newToken)));\n\n // Create a new session with the new token\n const newExpiresAt = new Date(Date.now() + 1000 * 60 * 60 * 24 * 30);\n\n // Insert the new session\n await sqlite.execute(\n `INSERT INTO ${SESSIONS_TABLE} (id, user_id, expires_at) VALUES (?, ?, ?)`,\n [newSessionId, session.userId, Math.floor(newExpiresAt.getTime() / 1000)],\n );\n\n // Delete the old session\n await sqlite.execute(`DELETE FROM ${SESSIONS_TABLE} WHERE id = ?`, [session.id]);\n\n // Return the new session and token\n const newSession: Session = {\n id: newSessionId,\n userId: session.userId,\n expiresAt: newExpiresAt,\n };\n\n return { session: newSession, user, newToken };\n }\n\n return { session, user };\n}\n\nexport async function invalidateSession(sessionId: string): Promise {\n await sqlite.execute(`DELETE FROM ${SESSIONS_TABLE} WHERE id = ?`, [sessionId]);\n}\n\nexport type SessionValidationResult =\n | { session: Session; user: User; newToken?: string }\n | { session: null; user: null };\n\nexport interface Session {\n id: string;\n userId: number;\n expiresAt: Date;\n}\n\nexport interface User {\n id: number;\n email?: string;\n username?: string;\n}",[],[158,176,205],[158,176],{"_105":215,"_98":216,"_159":217,"_161":160,"_162":142,"_163":141,"_165":121,"_107":218,"_102":219,"_167":189,"_169":220,"_170":25,"_171":-5,"_172":221,"_101":222},"a515583c-2c2e-11f0-b8b8-569c3dd06744","auth.ts","8e97d428-2b7e-11f0-a530-569c3dd06744",["D",1746723929814],58,"import { getCookie, setCookie } from \"npm:hono/cookie\";\nimport { createMiddleware } from \"npm:hono/factory\";\nimport { createMagicLinkToken, sendMagicLinkEmail, validateMagicLinkToken } from \"./database/magic-links.ts\";\nimport { createSession, generateSessionToken, invalidateSession, validateSessionToken } from \"./database/sessions.ts\";\n\nexport const authMiddleware = createMiddleware(async (c, next) => {\n const url = new URL(c.req.url);\n const path = url.pathname;\n const origin = c.req.header(\"Origin\");\n\n // CSRF Protection, more info: https://lucia-next.pages.dev/sessions/cookies/\n if (c.req.method !== \"GET\") {\n const host = new URL(c.req.url).hostname;\n if (origin === null || origin !== url.origin) {\n return c.text(\"CSRF Protection\", 401);\n }\n }\n\n // Handle magic link request\n if (path === \"/auth/magic-link\" && c.req.method === \"POST\") {\n try {\n const { email } = await c.req.json();\n\n if (!email || typeof email !== \"string\" || !email.includes(\"@\")) {\n return c.json({ success: false, error: \"Invalid email address\" }, 400);\n }\n\n // Create a magic link token\n const token = await createMagicLinkToken(email);\n\n // Send the magic link email\n const emailSent = await sendMagicLinkEmail(url.origin, email, token);\n\n if (!emailSent) {\n return c.json({\n success: false,\n error:\n \"Failed to send email. Val Town requires Pro subscription to send emails to addresses other than your own. See https://www.val.town/pricing\",\n }, 500);\n }\n\n return c.json({ success: true });\n } catch (error) {\n console.error(\"Error creating magic link:\", error);\n return c.json({ success: false, error: \"An unexpected error occurred\" }, 500);\n }\n }\n\n // Handle magic link validation\n if (path.startsWith(\"/auth/magic-link/\") && c.req.method === \"GET\") {\n const token = path.split(\"/\").pop();\n if (token) {\n const result = await validateMagicLinkToken(token);\n if (result.valid && result.userId) {\n // Create a new session\n const sessionToken = generateSessionToken();\n await createSession(sessionToken, result.userId);\n\n // Set the session cookie\n setCookie(c, \"session\", sessionToken, {\n httpOnly: true,\n secure: true,\n sameSite: \"Lax\",\n path: \"/\",\n maxAge: 60 * 60 * 24 * 30, // 30 days\n });\n\n // Redirect to the home page\n return c.redirect(\"/\");\n } else {\n // Invalid or expired token\n return c.redirect(\"/?error=invalid_token\");\n }\n }\n }\n\n // Regular session validation\n const token = getCookie(c, \"session\");\n if (token) {\n const { session, user, newToken } = await validateSessionToken(token);\n // If a new token was generated (session rotation), update the cookie\n if (newToken) {\n setCookie(c, \"session\", newToken, {\n httpOnly: true,\n secure: true,\n sameSite: \"Lax\",\n path: \"/\",\n maxAge: 60 * 60 * 24 * 30, // 30 days\n });\n }\n\n // Handle logout\n if (session && path === \"/auth/logout\") {\n await invalidateSession(session.id);\n\n setCookie(c, \"session\", \"\", {\n httpOnly: true,\n secure: true,\n sameSite: \"Lax\",\n path: \"/\",\n maxAge: 0,\n });\n\n return c.redirect(\"/\");\n }\n\n if (user) {\n c.set(\"user\", user);\n } else {\n // delete the session cookie\n setCookie(c, \"session\", \"\", {\n httpOnly: true,\n secure: true,\n sameSite: \"Lax\",\n path: \"/\",\n maxAge: 0,\n });\n }\n }\n\n // If you end up on the logout page when you weren't logged in, redirect to the home page\n if (path === \"/auth/logout\") {\n return c.redirect(\"/\");\n }\n\n await next();\n});",[],[158,216],{"_105":224,"_98":225,"_159":119,"_161":160,"_162":142,"_163":123,"_165":121,"_107":226,"_102":227,"_167":228,"_169":229,"_170":25,"_171":230,"_172":231,"_101":232},"190dc808-2c13-11f0-bb2a-569c3dd06744","index.ts",["D",1746712098471],13,"http","import { readFile, serveFile } from \"https://esm.town/v/std/utils@85-main/index.ts\";\nimport { sqlite } from \"https://esm.town/v/stevekrouse/sqlite\";\nimport { Hono } from \"npm:hono\";\nimport { authMiddleware } from \"./auth.ts\";\nimport { USER_TABLE } from \"./database/schema.ts\";\n\nconst app = new Hono();\n\n// Serve all /frontend files\napp.get(\"/frontend/**/*\", c => serveFile(c.req.path, import.meta.url));\n\napp.use(authMiddleware);\n\n// Serve index.html at the root / with bootstrapped data\napp.get(\"/\", async c => {\n let html = await readFile(\"/frontend/index.html\", import.meta.url);\n\n const user = c.get(\"user\");\n const dataScript = ``;\n\n // Insert the script right before the closing tag\n html = html.replace(\"\", `${dataScript}`);\n\n return c.html(html);\n});\n\n// API endpoint to update username\napp.post(\"/api/user/username\", async c => {\n const user = c.get(\"user\");\n\n if (!user) {\n return c.json({ success: false, error: \"Not authenticated\" }, 401);\n }\n\n try {\n const { username } = await c.req.json();\n\n if (!username || typeof username !== \"string\") {\n return c.json({ success: false, error: \"Invalid username\" }, 400);\n }\n\n // Validate username length (3-50 characters)\n if (username.length < 3 || username.length > 50) {\n return c.json({\n success: false,\n error: \"Username must be between 3 and 50 characters\",\n }, 400);\n }\n\n // Validate username contains only alphanumeric characters\n if (!/^[a-zA-Z0-9]+$/.test(username)) {\n return c.json({\n success: false,\n error: \"Username contains invalid characters\",\n }, 400);\n }\n\n // Update the username\n await sqlite.execute(\n `UPDATE ${USER_TABLE} SET username = ? WHERE id = ?`,\n [username, user.id],\n );\n\n return c.json({ success: true, username });\n } catch (error) {\n console.error(\"Error updating username:\", error);\n return c.json({ success: false, error: \"An unexpected error occurred\" }, 500);\n }\n});\n\n// Unwrap and rethrow Hono errors as the original error\n// If you delete this, all errors will be \"Internal Server Error\"\napp.onError((err, c) => {\n throw err;\n});\n\n// HTTP vals expect an exported \"fetch handler\"\n// This is how you \"run the server\" in Val Town with Hono\nexport default app.fetch;","lucia",[],[158,225],[158],{"_105":235,"_98":236,"_159":237,"_161":-5,"_162":142,"_163":164,"_165":121,"_107":238,"_102":29,"_167":168,"_169":-5,"_170":25,"_171":-5,"_172":239,"_101":294},"d588b4c6-2b7c-11f0-b025-569c3dd06744","frontend","e2fa51e9-9512-4c62-bb74-26b68500e8ce",["D",1746647560619],[240,274,284],{"_105":241,"_98":242,"_159":243,"_161":237,"_162":142,"_163":164,"_165":121,"_107":244,"_102":29,"_167":168,"_169":-5,"_170":25,"_171":-5,"_172":245,"_101":273},"d588ae2c-2b7c-11f0-b025-569c3dd06744","components","838fa396-65b9-424a-bedc-023d596f7fee",["D",1746647560619],[246,255,264],{"_105":247,"_98":248,"_159":249,"_161":243,"_162":142,"_163":250,"_165":121,"_107":251,"_102":178,"_167":189,"_169":252,"_170":25,"_171":-5,"_172":253,"_101":254},"7f68acb2-2c2c-11f0-a444-569c3dd06744","App.tsx","a338dd5e-2b84-11f0-962a-569c3dd06744",159,["D",1746723007609],"/** @jsxImportSource https://esm.sh/react@18.2.0 */\nimport { useEffect, useState } from \"https://esm.sh/react@18.2.0\";\nimport { LoginForm } from \"./LoginForm.tsx\";\nimport { UserProfile } from \"./UserProfile.tsx\";\n\ninterface User {\n id: number;\n email?: string;\n username?: string;\n}\n\ninterface InitialData {\n user: User | null;\n projectURL: string;\n error: string | null;\n}\n\nexport function App({ initialData }: { initialData: InitialData }) {\n const [user, setUser] = useState(initialData.user);\n const [error, setError] = useState(initialData.error);\n\n // Update user data after username change\n const updateUser = (updatedUser: User) => {\n setUser(updatedUser);\n };\n\n return (\n

Lucia Demo

\n\n {error && (\n

\n {error}\n setError(null)}\n >\n ×\n \n

\n )}\n\n

\n \n View Source Code\n \n

\n\n {user ? : }\n

\n );\n}",[],[236,242,248],{"_105":256,"_98":257,"_159":258,"_161":243,"_162":142,"_163":259,"_165":121,"_107":260,"_102":178,"_167":189,"_169":261,"_170":25,"_171":-5,"_172":262,"_101":263},"25a65b22-2c0c-11f0-8826-569c3dd06744","LoginForm.tsx","375416fe-2b83-11f0-a6d2-569c3dd06744",105,["D",1746709113129],"/** @jsxImportSource https://esm.sh/react@18.2.0 */\nimport { useState } from \"https://esm.sh/react@18.2.0\";\n\ninterface LoginFormProps {\n onError: (error: string) => void;\n}\n\nexport function LoginForm({ onError }: LoginFormProps) {\n const [email, setEmail] = useState(\"\");\n const [isSubmitting, setIsSubmitting] = useState(false);\n const [emailSent, setEmailSent] = useState(false);\n\n const handleSubmit = async (e: React.FormEvent) => {\n e.preventDefault();\n\n if (!email || !email.includes(\"@\")) {\n onError(\"Please enter a valid email address\");\n return;\n }\n\n setIsSubmitting(true);\n\n try {\n const response = await fetch(\"/auth/magic-link\", {\n method: \"POST\",\n headers: {\n \"Content-Type\": \"application/json\",\n },\n body: JSON.stringify({ email }),\n });\n\n const data = await response.json();\n\n if (!response.ok) {\n if (data.error) {\n onError(data.error);\n return;\n }\n throw new Error(data.error || \"Failed to send magic link\");\n }\n setEmailSent(true);\n } catch (err) {\n console.error(\"Error sending magic link:\", err);\n onError(err instanceof Error ? err.message : \"Failed to send magic link\");\n } finally {\n setIsSubmitting(false);\n }\n };\n\n if (emailSent) {\n return (\n

Check your email!

\n We've sent a magic link to {email}. Click the link in the email to log in.\n

\n );\n }\n\n return (\n

\n \n

\n );\n}",[],[236,242,257],{"_105":265,"_98":266,"_159":267,"_161":243,"_162":142,"_163":268,"_165":121,"_107":269,"_102":125,"_167":189,"_169":270,"_170":25,"_171":-5,"_172":271,"_101":272},"8e299820-2c0d-11f0-ad7d-569c3dd06744","UserProfile.tsx","419564e2-2b83-11f0-b874-569c3dd06744",108,["D",1746709717965],"/** @jsxImportSource https://esm.sh/react@18.2.0 */\nimport { useState } from \"https://esm.sh/react@18.2.0\";\n\ninterface User {\n id: number;\n email?: string;\n username?: string;\n}\n\ninterface UserProfileProps {\n user: User;\n onUpdate: (user: User) => void;\n}\n\nexport function UserProfile({ user, onUpdate }: UserProfileProps) {\n const [username, setUsername] = useState(user.username || \"\");\n const [isEditing, setIsEditing] = useState(false);\n const [isSubmitting, setIsSubmitting] = useState(false);\n const [error, setError] = useState(null);\n\n const handleSubmit = async (e: React.FormEvent) => {\n e.preventDefault();\n\n if (!username.trim()) {\n setError(\"Username cannot be empty\");\n return;\n }\n\n // Client-side validation to match server-side rules\n if (username.length < 3 || username.length > 50) {\n setError(\"Username must be between 3 and 50 characters\");\n return;\n }\n\n // Ensure username is only letters and numbers\n if (!/^[a-zA-Z0-9]+$/.test(username)) {\n setError(\"Username can only contain letters and numbers\");\n return;\n }\n\n setIsSubmitting(true);\n setError(null);\n\n try {\n const response = await fetch(\"/api/user/username\", {\n method: \"POST\",\n headers: {\n \"Content-Type\": \"application/json\",\n },\n body: JSON.stringify({ username }),\n });\n\n const data = await response.json();\n\n if (!response.ok) {\n throw new Error(data.error || \"Failed to update username\");\n }\n\n onUpdate({ ...user, username });\n setIsEditing(false);\n } catch (err) {\n console.error(\"Error updating username:\", err);\n setError(err instanceof Error ? err.message : \"Failed to update username\");\n } finally {\n setIsSubmitting(false);\n }\n };\n\n return (\n

Welcome!

\n Email: {user.email}\n

\n\n {error && (\n

\n {error}\n setError(null)}\n >\n ×\n \n

\n )}\n\n {isEditing\n ? (\n \n )\n : (\n

\n Username: {user.username\n ? {user.username}\n : Not set}\n

\n setIsEditing(true)}\n >\n {user.username ? \"Edit Username\" : \"Set Username\"}\n \n

\n )}\n\n

\n \n Logout\n \n

\n );\n}",[],[236,242,266],[236,242],{"_105":275,"_98":276,"_159":277,"_161":237,"_162":142,"_163":278,"_165":121,"_107":279,"_102":180,"_167":280,"_169":281,"_170":25,"_171":-5,"_172":282,"_101":283},"48d6c66a-2b83-11f0-8c17-569c3dd06744","index.html","8c6affca-1d04-4839-aec4-4f5b5aa8d076",51,["D",1746650331114],"file","\n\n \n \n \n Lucia Auth Demo\n \n \n \n

\n \n \n \n",[],[236,276],{"_105":285,"_98":286,"_159":287,"_161":237,"_162":142,"_163":288,"_165":121,"_107":289,"_102":290,"_167":189,"_169":291,"_170":25,"_171":-5,"_172":292,"_101":293},"94120fd6-2c2d-11f0-81ae-569c3dd06744","index.tsx","4625d407-4298-495d-97b2-f10a432ce363",163,["D",1746723471774],7,"/** @jsxImportSource https://esm.sh/react@18.2.0 */\nimport { createRoot } from \"https://esm.sh/react-dom@18.2.0/client\";\nimport { App } from \"./components/App.tsx\";\n\nconst initialDataString = document.getElementById(\"initial-data\")!.textContent as string;\nlet initialData = JSON.parse(initialDataString);\n\nconst urlParams = new URLSearchParams(window.location.search);\nconst errorParam = urlParams.get(\"error\");\nif (errorParam === \"invalid_token\" && !initialData.user) {\n initialData.error = \"Invalid or expired magic link. Please request a new one.\";\n} else {\n initialData.error = errorParam;\n}\n\ncreateRoot(document.getElementById(\"root\")!).render();",[],[236,286],[236],{"_105":296,"_98":297,"_159":298,"_161":-5,"_162":142,"_163":299,"_165":121,"_107":300,"_102":301,"_167":280,"_169":302,"_170":25,"_171":-5,"_172":303,"_101":304},"01a9b380-2c1c-11f0-bf2a-569c3dd06744","README.md","6e471353-de97-4574-8a7d-04470346ac53",158,["D",1746715924697],18,"# Lucia Auth Starter\n\nA demonstration of [Lucia, the guide](https://lucia-next.pages.dev/), and magic link authentication using Val Town.\n\nThis uses [Val Town SQLite](https://docs.val.town/std/sqlite/) and [Val Town Email](https://docs.val.town/std/email/), so you can Remix & roll-your-own-auth in a single-click. Literally zero set up required.\n\nNote: Sending emails to users besides yourself requires [Val Town Pro](https://www.val.town/pricing).\n\n## Features\n\n- Magic link authentication\n- Server-side rendering with client-side hydration\n- User profile management (username editing)\n- Session management with secure cookies\n- Responsive UI with Tailwind CSS\n\n## Authentication Flow\n\n1. User enters their email address on the login page\n2. A magic link is sent to the user's email\n3. User clicks the magic link in their email\n4. The server validates the token, creates a session, and sets a secure cookie\n5. User is redirected to the authenticated home page\n\n## Technical Implementation\n\n- **Database**:[Val Town SQLite](https://docs.val.town/std/sqlite/) for storing users, sessions, and magic link tokens\n- **Frontend**: React with Tailwind CSS\n- **Backend**: Hono.js for API routes and middleware\n- **Authentication**: Built by following the [Lucia guide](https://lucia-next.pages.dev/)\n\n## API Endpoints\n\nProvided by the Auth Middleware in `backend/auth.ts`:\n\n- `POST /auth/magic-link` - Request a magic link\n- `GET /auth/magic-link/:token` - Validate a magic link token\n- `POST /auth/logout` - Log out the current user\n\nIn the app's API, in `backend/index.ts`:\n\n- `POST /api/user/username` - Update the user's username\n\n## Notes\n\n- Email sending requires Val Town Pro subscription for sending to addresses other than your own\n- Magic links expire after 15 minutes\n- Session tokens are automatically rotated when 50% of their lifetime remains (15 days)\n- Sessions expire after 30 days\n\n## Todos\n\n- When I tried to make the magic link token single-use, it caused issues. I think the best practice there is something a bit more complicated, ie a GET request to an HTML page that makes a POST request.\n- When I tried to make the SameSite=Strict, the cookie stopped working. It's currently Lax, which I think is OK, but it'd be nice to know Strict isn't working.",[],[297],"files",[156,174,182,193,203,214,223,234,240,246,255,264,274,284,295],"counts",{"_309":29,"_310":164,"_311":312,"_313":29},"pulls","branches","forks",3,"envVars","contents",[316,319,322],{"_105":157,"_98":158,"_159":160,"_161":-5,"_162":142,"_163":164,"_165":121,"_107":317,"_102":29,"_167":168,"_169":-5,"_170":25,"_171":-5,"_101":318},["D",1746647560619],[158],{"_105":235,"_98":236,"_159":237,"_161":-5,"_162":142,"_163":164,"_165":121,"_107":320,"_102":29,"_167":168,"_169":-5,"_170":25,"_171":-5,"_101":321},["D",1746647560619],[236],{"_105":296,"_98":297,"_159":298,"_161":-5,"_162":142,"_163":299,"_165":121,"_107":323,"_102":301,"_167":280,"_169":302,"_170":25,"_171":-5,"_101":324},["D",1746715924697],[297],"upstreamProject",{"_105":327,"_98":328,"_113":329,"_115":-5,"_111":112,"_19":330},"96102714-f528-11ef-aa68-569c3dd06744","reactHonoStarter","Starter template with client-side React & Hono server",{"_96":331,"_137":332},"std","https://img.clerk.com/eyJ0eXBlIjoicHJveHkiLCJzcmMiOiJodHRwczovL2ltYWdlcy5jbGVyay5kZXYvdXBsb2FkZWQvaW1nXzJVaVhpQ1BId3dscVpBbkdZVWlMNjJtcjkxWS5wbmcifQ","upstreamBranch",{"_105":145,"_107":335,"_336":337,"_98":40,"_143":327,"_102":338,"_144":-5,"_146":-5,"_339":340,"_109":-5,"_153":25,"_111":112,"_152":331,"_14":341,"_151":328},["D",1740674013689],"updatedAt",["D",1748439933668],67,"lockfileKey","1748439933889-esm.town_v_std_reactHonoStarter@67-main","c606f87f-4d7e-48c8-9c39-ef5ab94aec49","emptyEnvVars","isNew","routes/_app.x.$handle.$name.code.$",{"_96":97,"_98":99,"_100":40,"_102":-7,"_101":71,"_103":346,"_154":350,"_305":396,"_280":-7,"_314":397,"_404":405,"_408":25,"_409":-5,"_410":411,"_412":413,"_414":415},{"_105":106,"_98":99,"_107":347,"_109":-5,"_110":25,"_111":112,"_113":114,"_115":116,"_12":117,"_118":119,"_120":121,"_122":123,"_124":125,"_14":126,"_127":128,"_129":128,"_130":131,"_132":131,"_133":131,"_134":128,"_135":128,"_19":348,"_139":349,"_153":25},["D",1746647560619],{"_96":97,"_137":138},{"_102":141,"_98":40,"_105":142,"_143":106,"_144":145,"_146":147,"_148":112,"_149":150,"_151":99,"_152":97},[351,372,393],{"_105":157,"_98":158,"_159":160,"_161":-5,"_162":142,"_163":164,"_165":121,"_107":166,"_102":29,"_167":168,"_169":-5,"_170":25,"_171":-5,"_172":352,"_101":371},[353,365,368],{"_105":175,"_98":176,"_159":177,"_161":160,"_162":142,"_163":178,"_165":121,"_107":179,"_102":180,"_167":168,"_169":-5,"_170":25,"_171":-5,"_172":354,"_101":364},[355,358,361],{"_105":183,"_98":184,"_159":185,"_161":177,"_162":142,"_163":186,"_165":121,"_107":187,"_102":188,"_167":189,"_169":190,"_170":25,"_171":-5,"_172":356,"_101":357},[],[158,176,184],{"_105":194,"_98":195,"_159":196,"_161":177,"_162":142,"_163":197,"_165":121,"_107":198,"_102":199,"_167":189,"_169":200,"_170":25,"_171":-5,"_172":359,"_101":360},[],[158,176,195],{"_105":204,"_98":205,"_159":206,"_161":177,"_162":142,"_163":207,"_165":121,"_107":208,"_102":209,"_167":189,"_169":210,"_170":25,"_171":-5,"_172":362,"_101":363},[],[158,176,205],[158,176],{"_105":215,"_98":216,"_159":217,"_161":160,"_162":142,"_163":141,"_165":121,"_107":218,"_102":219,"_167":189,"_169":220,"_170":25,"_171":-5,"_172":366,"_101":367},[],[158,216],{"_105":224,"_98":225,"_159":119,"_161":160,"_162":142,"_163":123,"_165":121,"_107":226,"_102":227,"_167":228,"_169":229,"_170":25,"_171":230,"_172":369,"_101":370},[],[158,225],[158],{"_105":235,"_98":236,"_159":237,"_161":-5,"_162":142,"_163":164,"_165":121,"_107":238,"_102":29,"_167":168,"_169":-5,"_170":25,"_171":-5,"_172":373,"_101":392},[374,386,389],{"_105":241,"_98":242,"_159":243,"_161":237,"_162":142,"_163":164,"_165":121,"_107":244,"_102":29,"_167":168,"_169":-5,"_170":25,"_171":-5,"_172":375,"_101":385},[376,379,382],{"_105":247,"_98":248,"_159":249,"_161":243,"_162":142,"_163":250,"_165":121,"_107":251,"_102":178,"_167":189,"_169":252,"_170":25,"_171":-5,"_172":377,"_101":378},[],[236,242,248],{"_105":256,"_98":257,"_159":258,"_161":243,"_162":142,"_163":259,"_165":121,"_107":260,"_102":178,"_167":189,"_169":261,"_170":25,"_171":-5,"_172":380,"_101":381},[],[236,242,257],{"_105":265,"_98":266,"_159":267,"_161":243,"_162":142,"_163":268,"_165":121,"_107":269,"_102":125,"_167":189,"_169":270,"_170":25,"_171":-5,"_172":383,"_101":384},[],[236,242,266],[236,242],{"_105":275,"_98":276,"_159":277,"_161":237,"_162":142,"_163":278,"_165":121,"_107":279,"_102":180,"_167":280,"_169":281,"_170":25,"_171":-5,"_172":387,"_101":388},[],[236,276],{"_105":285,"_98":286,"_159":287,"_161":237,"_162":142,"_163":288,"_165":121,"_107":289,"_102":290,"_167":189,"_169":291,"_170":25,"_171":-5,"_172":390,"_101":391},[],[236,286],[236],{"_105":296,"_98":297,"_159":298,"_161":-5,"_162":142,"_163":299,"_165":121,"_107":300,"_102":301,"_167":280,"_169":302,"_170":25,"_171":-5,"_172":394,"_101":395},[],[297],[351,353,355,358,361,365,368,372,374,376,379,382,386,389,393],[398,400,402],{"_105":157,"_98":158,"_159":160,"_161":-5,"_162":142,"_163":164,"_165":121,"_107":317,"_102":29,"_167":168,"_169":-5,"_170":25,"_171":-5,"_101":399},[158],{"_105":235,"_98":236,"_159":237,"_161":-5,"_162":142,"_163":164,"_165":121,"_107":320,"_102":29,"_167":168,"_169":-5,"_170":25,"_171":-5,"_101":401},[236],{"_105":296,"_98":297,"_159":298,"_161":-5,"_162":142,"_163":299,"_165":121,"_107":323,"_102":301,"_167":280,"_169":302,"_170":25,"_171":-5,"_101":403},[297],"upstream",{"_105":145,"_107":406,"_336":407,"_98":40,"_143":327,"_102":338,"_144":-5,"_146":-5,"_339":340,"_109":-5,"_153":25,"_111":112,"_152":331,"_14":341,"_151":328},["D",1740674013689],["D",1748439933668],"showCompareCallout","pull","ahead",168,"behind",28,"templates",[],"routes/_app","actionData","errors"]