@stjoseph/prumo 0.0.1

package/templates/mobile/src/features/auth/sign-up-form.tsx

@@ -0,0 +1,99 @@
+import { zodResolver } from '@hookform/resolvers/zod'
+import { useQueryClient } from '@tanstack/react-query'
+import { Controller, useForm } from 'react-hook-form'
+import { View } from 'react-native'
+import { z } from 'zod'
+import { ApiError } from '@/api-contract'
+import { Button } from '@/components/ui/button'
+import { Field } from '@/components/ui/field'
+import { FormError } from '@/features/forms/form-error'
+import { applyServerError } from '@/features/forms/server-errors'
+import type { SessionAuth } from './auth-client'
+import { sessionQuery } from './session'
+
+const schema = z.object({
+  name: z.string().min(1).max(80),
+  email: z.email(),
+  password: z.string().min(8),
+})
+
+type SignUpValues = z.infer<typeof schema>
+
+export function SignUpForm({ auth, onSignedUp }: { auth: SessionAuth; onSignedUp: () => void }) {
+  const queryClient = useQueryClient()
+  const form = useForm<SignUpValues>({
+    resolver: zodResolver(schema),
+    mode: 'onTouched',
+    reValidateMode: 'onChange',
+    defaultValues: { name: '', email: '', password: '' },
+  })
+  const { errors, isSubmitting } = form.formState
+
+  async function onSubmit(values: SignUpValues) {
+    const { error } = await auth.signUp.email(values)
+
+    if (error !== null) {
+      applyServerError(ApiError.fromAuthError(error), ['name', 'email', 'password'], form.setError)
+      return
+    }
+
+    await queryClient.invalidateQueries({ queryKey: sessionQuery(auth).queryKey })
+    onSignedUp()
+  }
+
+  return (
+    <View className="gap-6">
+      <FormError errors={errors} />
+      <Controller
+        control={form.control}
+        name="name"
+        render={({ field }) => (
+          <Field
+            label="Name"
+            autoComplete="name"
+            value={field.value}
+            onChangeText={field.onChange}
+            onBlur={field.onBlur}
+            error={errors.name?.message}
+          />
+        )}
+      />
+      <Controller
+        control={form.control}
+        name="email"
+        render={({ field }) => (
+          <Field
+            label="Email"
+            autoCapitalize="none"
+            autoComplete="email"
+            keyboardType="email-address"
+            value={field.value}
+            onChangeText={field.onChange}
+            onBlur={field.onBlur}
+            error={errors.email?.message}
+          />
+        )}
+      />
+      <Controller
+        control={form.control}
+        name="password"
+        render={({ field }) => (
+          <Field
+            label="Password"
+            secureTextEntry
+            autoComplete="new-password"
+            value={field.value}
+            onChangeText={field.onChange}
+            onBlur={field.onBlur}
+            error={errors.password?.message}
+          />
+        )}
+      />
+      <Button
+        label="Create account"
+        disabled={isSubmitting}
+        onPress={form.handleSubmit(onSubmit)}
+      />
+    </View>
+  )
+}

package/templates/mobile/src/features/clients/clients-context.tsx

@@ -0,0 +1,21 @@
+import { createContext, type ReactNode, useContext } from 'react'
+import type { ApiClient } from '@/api-contract'
+import type { AuthClient } from '@/features/auth/auth-client'
+
+type Clients = { api: ApiClient; auth: AuthClient }
+
+const ClientsContext = createContext<Clients | undefined>(undefined)
+
+export function ClientsProvider({ clients, children }: { clients: Clients; children: ReactNode }) {
+  return <ClientsContext.Provider value={clients}>{children}</ClientsContext.Provider>
+}
+
+export function useClients(): Clients {
+  const clients = useContext(ClientsContext)
+
+  if (clients === undefined) {
+    throw new Error('useClients must be used inside ClientsProvider')
+  }
+
+  return clients
+}

package/templates/mobile/src/features/forms/form-error.tsx

@@ -0,0 +1,16 @@
+import type { FieldErrors } from 'react-hook-form'
+import { Text } from 'react-native'
+
+export function FormError({ errors }: { errors: FieldErrors }) {
+  const message = errors.root?.server?.message
+
+  if (message === undefined) {
+    return null
+  }
+
+  return (
+    <Text accessibilityRole="alert" className="text-sm text-red-600">
+      {message}
+    </Text>
+  )
+}

package/templates/mobile/src/features/forms/server-errors.ts

@@ -0,0 +1,33 @@
+import type { FieldValues, Path, UseFormSetError } from 'react-hook-form'
+import { ApiError } from '@/api-contract'
+
+export const FORM_ERROR = 'root.server'
+
+export function applyServerError<T extends FieldValues>(
+  error: unknown,
+  fields: readonly Path<T>[],
+  setError: UseFormSetError<T>,
+): void {
+  if (!(error instanceof ApiError)) {
+    throw error
+  }
+
+  const unmatched: string[] = []
+
+  for (const [field, messages] of Object.entries(error.errors)) {
+    const message = messages.join(' ')
+
+    if ((fields as readonly string[]).includes(field)) {
+      setError(field as Path<T>, { type: 'server', message })
+    } else {
+      unmatched.push(message)
+    }
+  }
+
+  if (unmatched.length > 0 || Object.keys(error.errors).length === 0) {
+    const detail = unmatched.length > 0 ? unmatched.join(' ') : (error.detail ?? error.title)
+    const reference = error.requestId === undefined ? '' : ` (${error.requestId})`
+
+    setError(FORM_ERROR as Path<T>, { type: 'server', message: `${detail}${reference}` })
+  }
+}

package/templates/mobile/src/features/profile/profile-form.spec.tsx

@@ -0,0 +1,58 @@
+import { QueryClient, QueryClientProvider } from '@tanstack/react-query'
+import { render, screen, userEvent, within } from '@testing-library/react-native'
+import { createClient, type Profile } from '@/api-contract'
+import { API_URL, fakeTransport, json } from '../../../test/fake-transport'
+import { ProfileForm } from './profile-form'
+
+const profile: Profile = {
+  id: '01a09ffe-635c-77e5-9aeb-d3e9d1a7ee24',
+  userId: 'ef51f640-611b-4b9a-a188-510c455539eb',
+  displayName: 'Ana',
+  locale: 'en',
+  timezone: 'UTC',
+  createdAt: '2026-09-14T12:57:24.057Z',
+  updatedAt: '2026-09-14T12:57:24.057Z',
+}
+
+describe('ProfileForm', () => {
+  it('puts a server validation message on the field it names', async () => {
+    const api = createClient({
+      baseUrl: API_URL,
+      fetch: fakeTransport({
+        'PATCH /api/v1/users/me': () =>
+          json(
+            400,
+            {
+              type: 'about:blank',
+              title: 'Bad Request',
+              status: 400,
+              detail: 'Validation failed',
+              instance: '/api/v1/users/me',
+              requestId: 'req-1',
+              errors: { timezone: ['timezone must be a valid IANA zone'] },
+            },
+            'application/problem+json',
+          ),
+      }),
+    })
+
+    await render(
+      <QueryClientProvider client={new QueryClient()}>
+        <ProfileForm api={api} profile={profile} />
+      </QueryClientProvider>,
+    )
+
+    await userEvent.setup().press(screen.getByRole('button', { name: 'Save' }))
+
+    expect(
+      await within(screen.getByTestId('field-Timezone')).findByText(
+        'timezone must be a valid IANA zone',
+      ),
+    ).toBeOnTheScreen()
+    expect(
+      within(screen.getByTestId('field-Display name')).queryByText(
+        'timezone must be a valid IANA zone',
+      ),
+    ).toBeNull()
+  })
+})

package/templates/mobile/src/features/profile/profile-form.tsx

@@ -0,0 +1,96 @@
+import { zodResolver } from '@hookform/resolvers/zod'
+import { useMutation, useQueryClient } from '@tanstack/react-query'
+import { Controller, useForm } from 'react-hook-form'
+import { View } from 'react-native'
+import { z } from 'zod'
+import { type ApiClient, LOCALES, type Profile, profileQuery, updateProfile } from '@/api-contract'
+import { Button } from '@/components/ui/button'
+import { Field } from '@/components/ui/field'
+import { FormError } from '@/features/forms/form-error'
+import { applyServerError } from '@/features/forms/server-errors'
+
+const schema = z.object({
+  displayName: z.string().min(1).max(80),
+  locale: z.enum(LOCALES),
+  timezone: z.string().min(1).max(64),
+})
+
+type ProfileValues = z.infer<typeof schema>
+
+const FIELDS = ['displayName', 'locale', 'timezone'] as const
+
+export function ProfileForm({ api, profile }: { api: ApiClient; profile: Profile }) {
+  const queryClient = useQueryClient()
+  const form = useForm<ProfileValues>({
+    resolver: zodResolver(schema),
+    mode: 'onTouched',
+    reValidateMode: 'onChange',
+    defaultValues: {
+      displayName: profile.displayName,
+      locale: profile.locale,
+      timezone: profile.timezone,
+    },
+  })
+  const { errors, isSubmitting } = form.formState
+
+  const mutation = useMutation({
+    mutationFn: (values: ProfileValues) => updateProfile(api, values),
+    onSuccess: () => queryClient.invalidateQueries({ queryKey: profileQuery(api).queryKey }),
+  })
+
+  async function onSubmit(values: ProfileValues) {
+    try {
+      await mutation.mutateAsync(values)
+    } catch (error) {
+      applyServerError(error, FIELDS, form.setError)
+    }
+  }
+
+  return (
+    <View className="gap-6">
+      <FormError errors={errors} />
+      <Controller
+        control={form.control}
+        name="displayName"
+        render={({ field }) => (
+          <Field
+            label="Display name"
+            value={field.value}
+            onChangeText={field.onChange}
+            onBlur={field.onBlur}
+            error={errors.displayName?.message}
+          />
+        )}
+      />
+      <Controller
+        control={form.control}
+        name="locale"
+        render={({ field }) => (
+          <Field
+            label="Locale"
+            autoCapitalize="none"
+            value={field.value}
+            onChangeText={field.onChange}
+            onBlur={field.onBlur}
+            error={errors.locale?.message}
+          />
+        )}
+      />
+      <Controller
+        control={form.control}
+        name="timezone"
+        render={({ field }) => (
+          <Field
+            label="Timezone"
+            autoCapitalize="none"
+            value={field.value}
+            onChangeText={field.onChange}
+            onBlur={field.onBlur}
+            error={errors.timezone?.message}
+          />
+        )}
+      />
+      <Button label="Save" disabled={isSubmitting} onPress={form.handleSubmit(onSubmit)} />
+    </View>
+  )
+}

package/templates/mobile/src/features/storage/query-persister.ts

@@ -0,0 +1,15 @@
+import { createSyncStoragePersister } from '@tanstack/query-sync-storage-persister'
+import { storage, USER_KEYS } from './storage'
+
+export const QUERY_CACHE_MAX_AGE = 24 * 60 * 60 * 1000
+
+export const queryPersister = createSyncStoragePersister({
+  key: USER_KEYS.queryCache,
+  storage: {
+    getItem: (key) => storage.getString(key) ?? null,
+    setItem: (key, value) => storage.set(key, value),
+    removeItem: (key) => {
+      storage.remove(key)
+    },
+  },
+})

package/templates/mobile/src/features/storage/storage.ts

@@ -0,0 +1,11 @@
+import { createMMKV } from 'react-native-mmkv'
+
+export const storage = createMMKV({ id: 'app' })
+
+export const USER_KEYS = { queryCache: 'user.query-cache' } as const
+
+export function clearUserData(): void {
+  for (const key of Object.values(USER_KEYS)) {
+    storage.remove(key)
+  }
+}

package/templates/mobile/src/global.css

@@ -0,0 +1,3 @@
+@tailwind base;
+@tailwind components;
+@tailwind utilities;

package/templates/mobile/tailwind.config.js

@@ -0,0 +1,9 @@
+/** @type {import('tailwindcss').Config} */
+module.exports = {
+  content: ['./src/**/*.{ts,tsx}'],
+  presets: [require('nativewind/preset')],
+  theme: {
+    extend: {},
+  },
+  plugins: [],
+}

package/templates/mobile/test/fake-transport.ts

@@ -0,0 +1,23 @@
+import type { Transport } from '@/api-contract'
+
+export const API_URL = 'http://api.test'
+
+type Handler = (request: Request) => Response | Promise<Response>
+
+export function json(status: number, body: unknown, contentType = 'application/json'): Response {
+  return new Response(JSON.stringify(body), { status, headers: { 'content-type': contentType } })
+}
+
+export function fakeTransport(routes: Record<string, Handler>): Transport {
+  return async (input, init) => {
+    const request = new Request(input, init)
+    const key = `${request.method} ${new URL(request.url).pathname}`
+    const handler = routes[key]
+
+    if (handler === undefined) {
+      throw new Error(`No fake response for ${key}`)
+    }
+
+    return handler(request)
+  }
+}

package/templates/mobile/tsconfig.json

@@ -0,0 +1,21 @@
+{
+  "extends": "expo/tsconfig.base",
+  "compilerOptions": {
+    "strict": true,
+    "noUncheckedIndexedAccess": true,
+    "noFallthroughCasesInSwitch": true,
+    "forceConsistentCasingInFileNames": true,
+    "paths": {
+      "@/*": ["./src/*"]
+    },
+    "types": ["jest", "node"]
+  },
+  "include": [
+    "**/*.ts",
+    "**/*.tsx",
+    ".expo/types/**/*.ts",
+    "expo-env.d.ts",
+    "nativewind-env.d.ts",
+    "global.d.ts"
+  ]
+}

package/templates/site/.githooks/install.mjs

@@ -0,0 +1,18 @@
+import { execFileSync } from 'node:child_process'
+
+function insideRepository() {
+  try {
+    execFileSync('git', ['rev-parse', '--git-dir'], { stdio: 'ignore' })
+    return true
+  } catch (error) {
+    // No git, or no repository: an install from an archive or inside a container, where hooks have no use.
+    if (error.code === 'ENOENT' || error.status === 128) {
+      return false
+    }
+    throw error
+  }
+}
+
+if (insideRepository()) {
+  execFileSync('git', ['config', 'core.hooksPath', '.githooks'], { stdio: 'inherit' })
+}

package/templates/site/.githooks/pre-commit

@@ -0,0 +1,2 @@
+#!/bin/sh
+pnpm biome check --staged --write

package/templates/site/.githooks/pre-push

@@ -0,0 +1,2 @@
+#!/bin/sh
+pnpm typecheck

package/templates/site/README.md

@@ -0,0 +1,28 @@
+# site
+
+## Requirements
+
+Node 22.17 or later, and pnpm. The build downloads its font from Google Fonts, so it needs network access.
+
+## Running it
+
+```sh
+pnpm install
+pnpm dev
+```
+
+The site runs on `http://localhost:3000`. It calls no API yet; when a page needs data, it fetches it on the server.
+
+## Everyday commands
+
+| Command | What it does |
+|---|---|
+| `pnpm test` | Checks that each indexable page exports a title and a description |
+| `pnpm lint` | Biome |
+| `pnpm typecheck` | Generates Next's route types, then `tsc --noEmit`; also run before every push |
+| `pnpm build` · `pnpm start` | Production build, then serves it |
+
+## Conventions
+
+The rules this project follows live in `.prumo/`, and `AGENTS.md` points to them. Read those before
+changing how something is done.

package/templates/site/biome.jsonc

@@ -0,0 +1,12 @@
+{
+  "$schema": "https://biomejs.dev/schemas/2.5.13/schema.json",
+  "vcs": { "enabled": true, "clientKind": "git", "useIgnoreFile": true },
+  "files": { "includes": ["**", "!.next", "!dist", "!coverage"] },
+  "formatter": { "indentStyle": "space", "indentWidth": 2, "lineWidth": 100 },
+  "linter": {
+    "rules": { "preset": "recommended" },
+    "domains": { "next": "recommended", "react": "recommended" }
+  },
+  "javascript": { "formatter": { "quoteStyle": "single", "semicolons": "asNeeded" } },
+  "css": { "parser": { "tailwindDirectives": true } }
+}

package/templates/site/components.json

@@ -0,0 +1,25 @@
+{
+  "$schema": "https://ui.shadcn.com/schema.json",
+  "style": "base-nova",
+  "rsc": true,
+  "tsx": true,
+  "tailwind": {
+    "config": "",
+    "css": "src/app/globals.css",
+    "baseColor": "neutral",
+    "cssVariables": true,
+    "prefix": ""
+  },
+  "iconLibrary": "lucide",
+  "rtl": false,
+  "aliases": {
+    "components": "@/components",
+    "utils": "@/lib/utils",
+    "ui": "@/components/ui",
+    "lib": "@/lib",
+    "hooks": "@/hooks"
+  },
+  "menuColor": "default",
+  "menuAccent": "subtle",
+  "registries": {}
+}

package/templates/site/gitignore

@@ -0,0 +1,7 @@
+node_modules
+.next
+out
+coverage
+*.tsbuildinfo
+next-env.d.ts
+.env*

package/templates/site/next.config.ts

@@ -0,0 +1,7 @@
+import type { NextConfig } from 'next'
+
+const nextConfig: NextConfig = {
+  agentRules: false,
+}
+
+export default nextConfig

package/templates/site/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "site",
+  "version": "0.0.1",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "next dev",
+    "build": "next build",
+    "start": "next start",
+    "lint": "biome check",
+    "typecheck": "next typegen && tsc --noEmit",
+    "test": "vitest run",
+    "prepare": "node .githooks/install.mjs"
+  },
+  "dependencies": {
+    "@base-ui/react": "1.8.0",
+    "class-variance-authority": "0.7.1",
+    "cn": "0.3.0",
+    "lucide-react": "1.45.0",
+    "next": "16.3.5",
+    "react": "19.2.3",
+    "react-dom": "19.2.3",
+    "shadcn": "4.21.0",
+    "tw-animate-css": "1.4.0"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "2.5.13",
+    "@tailwindcss/postcss": "4.3.3",
+    "@types/node": "24.13.4",
+    "@types/react": "19.2.18",
+    "@types/react-dom": "19.2.7",
+    "@vitejs/plugin-react": "6.1.1",
+    "tailwindcss": "4.3.3",
+    "typescript": "6.0.3",
+    "vitest": "4.1.11"
+  },
+  "engines": {
+    "node": ">=22.17.0"
+  }
+}

package/templates/site/pnpm-workspace.yaml

@@ -0,0 +1,5 @@
+allowBuilds:
+  # Denied by create-next-app itself; Next resolves sharp's platform binary without running its install script.
+  sharp: false
+  # Denied by create-next-app itself; its prebuilt binary arrives as an optional dependency.
+  unrs-resolver: false

package/templates/site/postcss.config.mjs

@@ -0,0 +1,7 @@
+const config = {
+  plugins: {
+    '@tailwindcss/postcss': {},
+  },
+}
+
+export default config