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}",[],[152,170,177],{"_103":187,"_95":188,"_153":189,"_155":171,"_156":139,"_157":190,"_159":119,"_105":191,"_100":192,"_161":182,"_163":193,"_164":27,"_165":-5,"_166":194,"_98":195},"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();",[],[152,170,188],{"_103":197,"_95":198,"_153":199,"_155":171,"_156":139,"_157":200,"_159":119,"_105":201,"_100":202,"_161":182,"_163":203,"_164":27,"_165":-5,"_166":204,"_98":205},"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}",[],[152,170,198],[152,170],{"_103":208,"_95":209,"_153":210,"_155":154,"_156":139,"_157":138,"_159":119,"_105":211,"_100":212,"_161":182,"_163":213,"_164":27,"_165":-5,"_166":214,"_98":215},"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});",[],[152,209],{"_103":217,"_95":218,"_153":117,"_155":154,"_156":139,"_157":121,"_159":119,"_105":219,"_100":220,"_161":221,"_163":222,"_164":27,"_165":223,"_166":224,"_98":225},"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",[],[152,218],[152],{"_103":228,"_95":229,"_153":230,"_155":-5,"_156":139,"_157":158,"_159":119,"_105":231,"_100":31,"_161":162,"_163":-5,"_164":27,"_165":-5,"_166":232,"_98":288},"d588b4c6-2b7c-11f0-b025-569c3dd06744","frontend","e2fa51e9-9512-4c62-bb74-26b68500e8ce",["D",1746647560619],[233,268,278],{"_103":234,"_95":235,"_153":236,"_155":230,"_156":139,"_157":158,"_159":119,"_105":237,"_100":31,"_161":162,"_163":-5,"_164":27,"_165":-5,"_166":238,"_98":267},"d588ae2c-2b7c-11f0-b025-569c3dd06744","components","838fa396-65b9-424a-bedc-023d596f7fee",["D",1746647560619],[239,248,257],{"_103":240,"_95":241,"_153":242,"_155":236,"_156":139,"_157":243,"_159":119,"_105":244,"_100":123,"_161":182,"_163":245,"_164":27,"_165":-5,"_166":246,"_98":247},"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}",[],[229,235,241],{"_103":249,"_95":250,"_153":251,"_155":236,"_156":139,"_157":252,"_159":119,"_105":253,"_100":123,"_161":182,"_163":254,"_164":27,"_165":-5,"_166":255,"_98":256},"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}",[],[229,235,250],{"_103":258,"_95":259,"_153":260,"_155":236,"_156":139,"_157":261,"_159":119,"_105":262,"_100":263,"_161":182,"_163":264,"_164":27,"_165":-5,"_166":265,"_98":266},"8e299820-2c0d-11f0-ad7d-569c3dd06744","UserProfile.tsx","419564e2-2b83-11f0-b874-569c3dd06744",108,["D",1746709717965],6,"/** @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}",[],[229,235,259],[229,235],{"_103":269,"_95":270,"_153":271,"_155":230,"_156":139,"_157":272,"_159":119,"_105":273,"_100":173,"_161":274,"_163":275,"_164":27,"_165":-5,"_166":276,"_98":277},"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",[],[229,270],{"_103":279,"_95":280,"_153":281,"_155":230,"_156":139,"_157":282,"_159":119,"_105":283,"_100":284,"_161":182,"_163":285,"_164":27,"_165":-5,"_166":286,"_98":287},"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();",[],[229,280],[229],{"_103":290,"_95":291,"_153":292,"_155":-5,"_156":139,"_157":293,"_159":119,"_105":294,"_100":295,"_161":274,"_163":296,"_164":27,"_165":-5,"_166":297,"_98":298},"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.",[],[291],"files",[150,168,175,186,196,207,216,227,233,239,248,257,268,278,289],"counts",{"_303":31,"_304":158,"_305":158,"_306":31},"pulls","branches","forks","envVars","contents",[],{"_103":217,"_95":218,"_153":117,"_155":154,"_156":139,"_157":121,"_159":119,"_105":310,"_100":220,"_161":221,"_163":222,"_164":27,"_165":223,"_98":311},["D",1746712098471],[152,218],"upstream",{"_103":314,"_95":315,"_111":316,"_113":-5,"_109":110,"_21":317},"96102714-f528-11ef-aa68-569c3dd06744","reactHonoStarter","Starter template with client-side React & Hono server",{"_93":318,"_134":319},"std","https://img.clerk.com/eyJ0eXBlIjoicHJveHkiLCJzcmMiOiJodHRwczovL2ltYWdlcy5jbGVyay5kZXYvdXBsb2FkZWQvaW1nXzJVaVhpQ1BId3dscVpBbkdZVWlMNjJtcjkxWS5wbmcifQ","emptyEnvVars","isNew","routes/_app.x.$handle.$name.code.$",{"_93":94,"_95":96,"_97":41,"_100":-7,"_98":99,"_101":324,"_148":328,"_299":374,"_274":375,"_307":377,"_312":378,"_386":27,"_387":-5},{"_103":104,"_95":96,"_105":325,"_107":-5,"_108":27,"_109":110,"_111":112,"_113":114,"_12":115,"_116":117,"_118":119,"_120":121,"_122":123,"_124":125,"_126":125,"_127":128,"_129":128,"_130":128,"_131":125,"_132":27,"_21":326,"_136":327},["D",1746647560619],{"_93":94,"_134":135},{"_100":138,"_95":41,"_103":139,"_140":104,"_141":142,"_143":144,"_145":110,"_146":147},[329,350,371],{"_103":151,"_95":152,"_153":154,"_155":-5,"_156":139,"_157":158,"_159":119,"_105":160,"_100":31,"_161":162,"_163":-5,"_164":27,"_165":-5,"_166":330,"_98":349},[331,343,346],{"_103":169,"_95":170,"_153":171,"_155":154,"_156":139,"_157":123,"_159":119,"_105":172,"_100":173,"_161":162,"_163":-5,"_164":27,"_165":-5,"_166":332,"_98":342},[333,336,339],{"_103":176,"_95":177,"_153":178,"_155":171,"_156":139,"_157":179,"_159":119,"_105":180,"_100":181,"_161":182,"_163":183,"_164":27,"_165":-5,"_166":334,"_98":335},[],[152,170,177],{"_103":187,"_95":188,"_153":189,"_155":171,"_156":139,"_157":190,"_159":119,"_105":191,"_100":192,"_161":182,"_163":193,"_164":27,"_165":-5,"_166":337,"_98":338},[],[152,170,188],{"_103":197,"_95":198,"_153":199,"_155":171,"_156":139,"_157":200,"_159":119,"_105":201,"_100":202,"_161":182,"_163":203,"_164":27,"_165":-5,"_166":340,"_98":341},[],[152,170,198],[152,170],{"_103":208,"_95":209,"_153":210,"_155":154,"_156":139,"_157":138,"_159":119,"_105":211,"_100":212,"_161":182,"_163":213,"_164":27,"_165":-5,"_166":344,"_98":345},[],[152,209],{"_103":217,"_95":218,"_153":117,"_155":154,"_156":139,"_157":121,"_159":119,"_105":219,"_100":220,"_161":221,"_163":222,"_164":27,"_165":223,"_166":347,"_98":348},[],[152,218],[152],{"_103":228,"_95":229,"_153":230,"_155":-5,"_156":139,"_157":158,"_159":119,"_105":231,"_100":31,"_161":162,"_163":-5,"_164":27,"_165":-5,"_166":351,"_98":370},[352,364,367],{"_103":234,"_95":235,"_153":236,"_155":230,"_156":139,"_157":158,"_159":119,"_105":237,"_100":31,"_161":162,"_163":-5,"_164":27,"_165":-5,"_166":353,"_98":363},[354,357,360],{"_103":240,"_95":241,"_153":242,"_155":236,"_156":139,"_157":243,"_159":119,"_105":244,"_100":123,"_161":182,"_163":245,"_164":27,"_165":-5,"_166":355,"_98":356},[],[229,235,241],{"_103":249,"_95":250,"_153":251,"_155":236,"_156":139,"_157":252,"_159":119,"_105":253,"_100":123,"_161":182,"_163":254,"_164":27,"_165":-5,"_166":358,"_98":359},[],[229,235,250],{"_103":258,"_95":259,"_153":260,"_155":236,"_156":139,"_157":261,"_159":119,"_105":262,"_100":263,"_161":182,"_163":264,"_164":27,"_165":-5,"_166":361,"_98":362},[],[229,235,259],[229,235],{"_103":269,"_95":270,"_153":271,"_155":230,"_156":139,"_157":272,"_159":119,"_105":273,"_100":173,"_161":274,"_163":275,"_164":27,"_165":-5,"_166":365,"_98":366},[],[229,270],{"_103":279,"_95":280,"_153":281,"_155":230,"_156":139,"_157":282,"_159":119,"_105":283,"_100":284,"_161":182,"_163":285,"_164":27,"_165":-5,"_166":368,"_98":369},[],[229,280],[229],{"_103":290,"_95":291,"_153":292,"_155":-5,"_156":139,"_157":293,"_159":119,"_105":294,"_100":295,"_161":274,"_163":296,"_164":27,"_165":-5,"_166":372,"_98":373},[],[291],[329,331,333,336,339,343,346,350,352,354,357,360,364,367,371],{"_103":217,"_95":218,"_153":117,"_155":154,"_156":139,"_157":121,"_159":119,"_105":310,"_100":220,"_161":221,"_163":222,"_164":27,"_165":223,"_98":376},[152,218],[],{"_103":142,"_105":379,"_380":381,"_95":41,"_140":314,"_100":144,"_141":-5,"_143":-5,"_382":383,"_132":27,"_109":110,"_384":318,"_385":315},["D",1740674013689],"updatedAt",["D",1744030641875],"lockfileKey","1744473899907-esm.town_v_std_reactHonoStarter@39-main","userHandle","projectName","showCompareCallout","pull","routes/_app","actionData","errors"]