create-fate 1.0.4 → 1.3.0

package/templates/fate/cloudflare/client/src/ui/Header.tsx

@@ -0,0 +1,98 @@
+import Stack from '@nkzw/stack';
+import { useRouter } from '@void/react';
+import { ChevronLeft, LogIn, LogOut, Search } from 'lucide-react';
+import AuthClient from '../user/AuthClient.tsx';
+import { Button } from './Button.tsx';
+import Link from './Link.tsx';
+import LocaleSwitcher from './LocaleSwitcher.tsx';
+
+export default function Header() {
+  const router = useRouter();
+  const pathname = router.path;
+  const { data: session, isPending } = AuthClient.useSession();
+
+  return (
+    <header className="sticky top-0 z-50 border-b border-white/60 bg-white/60 backdrop-blur dark:border-neutral-800 dark:bg-neutral-950/70">
+      <Stack
+        alignCenter
+        between
+        className="max-w-8xl relative container mx-auto h-16 px-6 lg:px-8"
+        gap={16}
+      >
+        <Link
+          href="/"
+          onClick={() =>
+            pathname !== '/' && history.state?.idx > 0 ? history.back() : router.visit('/')
+          }
+        >
+          <Stack alignCenter gap={12}>
+            <div className="squircle relative flex h-10 w-10 items-center justify-center bg-linear-to-br from-gray-100 to-gray-200 text-white shadow-lg shadow-gray-500/20 transition duration-250 hover:scale-110 active:scale-90">
+              {pathname === '/' ? (
+                <svg
+                  className="h-6 w-6 text-gray-500"
+                  preserveAspectRatio="xMidYMax"
+                  viewBox="0 0 160 160"
+                  xmlns="http://www.w3.org/2000/svg"
+                >
+                  <path
+                    d="M108.301 17.465h.272c1.797-.005 3.563.177 5.331.496l.349.063c5.588 1.02 10.731 3.447 15.201 6.933l.347.267c1.579 1.26 3.083 2.684 4.386 4.227l.161.186c4.018 4.719 6.924 10.686 7.767 16.852l.033.239c.262 1.848.351 3.688.352 5.551l.001.307c-.001 1.623-.092 3.188-.386 4.788l-.05.292c-1.003 5.874-3.476 11.447-7.286 16.034l-.29.358c-1.422 1.721-3.011 3.382-4.797 4.729l-.444.354c-3.046 2.405-6.436 4.147-10.084 5.442l-.497.186c-1.766.627-3.615.974-5.465 1.266l-.364.058c-1.591.238-3.185.286-4.791.281h-.499l-1.339-.002h-1.408c-.886-.001-1.772-.001-2.656-.003-3.085-.001-6.163-.005-9.247-.008v-12.78l3.606-.006 2.282-.007c1.205-.006 2.407-.01 3.611-.011.878 0 1.754-.003 2.63-.007.462-.002.928-.005 1.389-.002 6.302.01 12.003-1.72 16.65-6.117l.291-.272c3.951-3.807 6.097-9.302 6.241-14.736.04-3.078-.476-6.048-1.68-8.892l-.104-.244c-2.382-5.559-6.98-9.439-12.504-11.675-2.204-.816-4.522-1.16-6.863-1.134-.301.004-.606.004-.909.001-1.677.003-3.304.127-4.924.591l-.331.098c-2.625.758-5.093 1.928-7.254 3.607l-.323.249c-1.046.817-2.031 1.682-2.873 2.71l-.154.179c-2.354 2.782-3.9 5.988-4.727 9.529l-.054.229c-.391 1.8-.423 3.633-.42 5.471l-.001.74c.002 1.4.001 2.801-.004 4.201l-.004 3.779c0 1.824-.001 3.649-.003 5.473l-.006 2.813-.005 6.076-.001.267-.008 8.614c-.001 2.023-.004 4.045-.006 6.066v.259l-.004 2.55-.006 5.46c0 1.331-.001 2.658-.003 3.985-.002.72-.002 1.438-.002 2.156 0 .658 0 1.317-.002 1.978v.708c.004 2.098-.07 4.214-.545 6.263l-.077.359-.161.716c-.071.302-.136.605-.199.909-.55 2.538-1.6 5.067-2.832 7.348l-.214.42c-.965 1.921-2.22 3.714-3.574 5.38l-.152.183c-.78.973-1.639 1.866-2.519 2.751l-.308.313a25.81 25.81 0 0 1-2.226 1.955l-.22.179c-3.698 2.953-7.975 5.044-12.538 6.262-.212.056-.422.115-.631.176-8.366 2.287-17.8.738-25.278-3.512-3.639-2.122-7.171-4.945-9.721-8.307-.121-.15-.241-.298-.356-.448a36.247 36.247 0 0 1-2.605-3.814l-.144-.234c-.889-1.466-1.562-3.034-2.222-4.617l-.11-.265c-3.253-7.791-2.911-17.367.184-25.133.865-2.069 1.869-4.089 3.123-5.951l.172-.261a31.91 31.91 0 0 1 2.547-3.29l.229-.263c.13-.152.266-.304.396-.452l.425-.493c1.216-1.389 2.593-2.615 4.068-3.723.208-.157.414-.315.62-.476 1.184-.901 2.437-1.665 3.729-2.4l.272-.159c1.586-.893 3.235-1.573 4.934-2.21l.253-.097c4.232-1.567 8.615-1.836 13.079-1.82 1.359 0 2.732.002 4.093.007 1.209.005 2.417.006 3.621.006 1.899.002 3.794.007 5.688.012v12.78l-3.612.013-2.282.011c-1.201.005-2.401.012-3.61.016-.876.003-1.751.005-2.629.013-.463.002-.924.005-1.387.006-4.322.005-8.193.592-12.033 2.662l-.217.114c-1.458.773-2.697 1.731-3.908 2.849-.206.185-.413.362-.63.535-.435.376-.794.788-1.16 1.232l-.153.18a21.18 21.18 0 0 0-4.474 8.651l-.094.342c-.42 1.682-.54 3.395-.536 5.127v.272c.019 5.672 2.392 10.671 6.206 14.769l.215.237c3.296 3.453 8.483 5.917 13.247 6.046.448.008.896.01 1.345.01.276 0 .553.003.835.005 4.917.019 9.864-1.73 13.577-4.995l.303-.267c.299-.263.592-.527.881-.799l.262-.247c.787-.756 1.451-1.599 2.104-2.474l.151-.201c1.929-2.606 3.117-5.723 3.635-8.909l.059-.362c.194-1.296.21-2.573.207-3.883l.003-.74v-2.02c0-.73 0-1.459.005-2.188v-3.782c0-1.827.004-3.654.007-5.481 0-.939 0-1.877.004-2.816l.003-6.082v-.268c.005-2.876.008-5.75.008-8.627l.013-8.883c.004-1.823.004-3.646.004-5.469 0-1.33.004-2.659.004-3.989.003-.721.003-1.442.003-2.159v-1.98c.005-.237.005-.473 0-.711-.011-8.523 3.072-17.023 8.941-23.268.244-.263.483-.531.717-.805.416-.48.861-.918 1.324-1.352l.252-.232a26.259 26.259 0 0 1 2.184-1.812l.46-.349c1.39-1.058 2.837-1.951 4.375-2.775l.318-.172c5.005-2.666 10.5-3.877 16.15-3.889Z"
+                    fill="currentColor"
+                    style={{ transformBox: 'fill-box', transformOrigin: '50% 50%' }}
+                    transform="rotate(-31 0 0)"
+                  />
+                </svg>
+              ) : (
+                <ChevronLeft className="h-6 w-6 text-gray-500" />
+              )}
+            </div>
+            <div className="opacity-100 transition-opacity duration-250 hover:opacity-70">
+              <span className="bg-linear-to-r from-gray-500 to-gray-900 bg-clip-text text-xl font-semibold text-transparent dark:from-gray-200 dark:to-white">
+                <span className="italic">fate</span>
+              </span>
+              <p className="hidden text-xs text-muted-foreground sm:block">
+                <fbt desc="fate library tagline">A modern data client for React.</fbt>
+              </p>
+            </div>
+          </Stack>
+        </Link>
+        <Stack alignCenter>
+          <LocaleSwitcher />
+          <Button asChild size="sm" variant="ghost">
+            <Link to="/search">
+              <Search className="h-4 w-4" />
+              <span className="hidden sm:inline">
+                <fbt desc="Search button">Search</fbt>
+              </span>
+            </Link>
+          </Button>
+          <div className="flex w-9 justify-end sm:w-24">
+            {session ? (
+              <Button asChild className="w-full" size="sm" variant="ghost">
+                <Stack
+                  alignCenter
+                  as="a"
+                  className="text-sm font-medium text-gray-700 transition hover:text-gray-900 dark:text-gray-200 dark:hover:text-white"
+                  gap={4}
+                  onClick={() => AuthClient.signOut()}
+                >
+                  <LogOut className="h-4 w-4" />
+                  <span className="hidden sm:inline">
+                    <fbt desc="Logout button">Logout</fbt>
+                  </span>
+                </Stack>
+              </Button>
+            ) : !isPending ? (
+              <Button asChild className="w-full" size="sm" variant="ghost">
+                <Link to="/login">
+                  <LogIn className="h-4 w-4" /> <fbt desc="Login button">Login</fbt>
+                </Link>
+              </Button>
+            ) : (
+              <div aria-hidden className="h-9 w-full" />
+            )}
+          </div>
+        </Stack>
+      </Stack>
+    </header>
+  );
+}

package/templates/fate/cloudflare/client/src/ui/Input.tsx

@@ -0,0 +1,17 @@
+import { InputHTMLAttributes, Ref } from 'react';
+import cx from '../lib/cx.tsx';
+
+export default function Input({
+  className,
+  ...props
+}: InputHTMLAttributes<HTMLInputElement> & { ref?: Ref<HTMLInputElement> }) {
+  return (
+    <input
+      className={cx(
+        'border-input bg-background text-foreground focus-visible:ring-ring focus-visible:ring-offset-background flex w-32 squircle border px-3 py-2 text-sm shadow-sm transition-colors focus-visible:ring-2 focus-visible:ring-offset-0 focus-visible:outline-none disabled:cursor-not-allowed disabled:opacity-50 dark:bg-neutral-900/40',
+        className,
+      )}
+      {...props}
+    />
+  );
+}

package/templates/fate/cloudflare/client/src/ui/Link.tsx

@@ -0,0 +1,11 @@
+import { Link as VoidLink } from '@void/react';
+import type { ComponentProps } from 'react';
+
+export type LinkProps = Omit<ComponentProps<typeof VoidLink>, 'href'> & {
+  href?: string;
+  to?: string;
+};
+
+export default function Link({ href, to, ...props }: LinkProps) {
+  return <VoidLink href={href ?? to ?? '/'} {...props} />;
+}

package/templates/fate/cloudflare/client/src/ui/LocaleSwitcher.tsx

@@ -0,0 +1,52 @@
+import { VStack } from '@nkzw/stack';
+import { cx } from 'class-variance-authority';
+import { useLocaleContext } from 'fbtee';
+import { Languages } from 'lucide-react';
+import AvailableLanguages from '../lib/AvailableLanguages.tsx';
+import { Button } from './Button.tsx';
+import Card from './Card.tsx';
+
+export default function LocaleSwitcher() {
+  const { locale: currentLocale, setLocale } = useLocaleContext();
+
+  return (
+    <>
+      <Button asChild size="sm" variant="ghost">
+        <button popoverTarget="locale-switcher" popoverTargetAction="show">
+          <Languages className="h-4 w-4" />
+          <span className="hidden sm:inline">
+            <fbt desc="Locale switcher button">Change Language</fbt>
+          </span>
+        </button>
+      </Button>
+      <Card
+        className="translate-y-50 justify-self-center border-slate-100 bg-white shadow transition-all dark:bg-black"
+        id="locale-switcher"
+        popover="auto"
+      >
+        <VStack alignCenter center className="w-64" gap={12} padding={16}>
+          {[...AvailableLanguages.entries()].map(([locale, name]) => (
+            <Button
+              action={() => {
+                setLocale(locale);
+                localStorage.setItem('fbtee:locale', locale);
+              }}
+              asChild
+              className={cx(
+                'transition-background border-slate-200 bg-transparent duration-150 hover:border-slate-300 hover:bg-slate-200 dark:hover:bg-slate-900 dark:text-white active:py-2',
+                {
+                  'bg-slate-100 dark:bg-slate-900': currentLocale === locale,
+                },
+              )}
+              key={locale}
+              size="sm"
+              variant="outline"
+            >
+              <a className="w-full flex-1 cursor-pointer p-2">{name}</a>
+            </Button>
+          ))}
+        </VStack>
+      </Card>
+    </>
+  );
+}

package/templates/fate/cloudflare/client/src/ui/PostCard.tsx

@@ -0,0 +1,303 @@
+import type { Comment as InlineComment, Post } from '@app/server/src/router.ts';
+import Stack, { VStack } from '@nkzw/stack';
+import { cx } from 'class-variance-authority';
+import { fbs } from 'fbtee';
+import {
+  KeyboardEvent,
+  Suspense,
+  startTransition,
+  useActionState,
+  useCallback,
+  useEffect,
+  useState,
+} from 'react';
+import { ErrorBoundary } from 'react-error-boundary';
+import {
+  defer,
+  type Deferred,
+  useListView,
+  useFateClient,
+  useView,
+  view,
+  ViewRef,
+} from 'react-fate';
+import { Button } from '../ui/Button.tsx';
+import Card from '../ui/Card.tsx';
+import AuthClient from '../user/AuthClient.tsx';
+import CommentCard, { CommentView } from './CommentCard.tsx';
+import H3 from './H3.tsx';
+import Link from './Link.tsx';
+import { UserView } from './UserCard.tsx';
+
+const CommentConnectionView = {
+  args: { first: 3 },
+  items: {
+    node: CommentView,
+  },
+};
+
+export const PostView = view<Post>()({
+  author: UserView,
+  commentCount: true,
+  comments: defer(CommentConnectionView),
+  content: true,
+  id: true,
+  likes: true,
+  title: true,
+});
+
+const PostComments = ({
+  comments,
+  post,
+}: {
+  comments: Deferred<{ items: ReadonlyArray<{ node: ViewRef<'Comment'> }> }>;
+  post: { commentCount: number; id: string; title: string };
+}) => {
+  const [items, loadNext] = useListView(CommentConnectionView, comments);
+
+  return items.length > 0 ? (
+    <VStack gap={12}>
+      {items.map(({ node }) => (
+        <CommentCard comment={node} key={node.id} post={post} />
+      ))}
+      {loadNext ? (
+        <Button onClick={loadNext} variant="ghost">
+          <fbt desc="Load more comments button">Load more comments</fbt>
+        </Button>
+      ) : null}
+    </VStack>
+  ) : null;
+};
+
+const CommentInput = ({
+  error,
+  post,
+}: {
+  error?: unknown;
+  post: { commentCount: number; id: string };
+}) => {
+  const fate = useFateClient();
+  const { data: session } = AuthClient.useSession();
+  const user = session?.user;
+  const [commentText, setCommentText] = useState('');
+
+  const [addCommentResult, handleAddComment, addCommentIsPending] = useActionState(async () => {
+    const content = commentText.trim();
+
+    if (!content) {
+      return;
+    }
+
+    const result = await fate.mutations.comment.add({
+      input: { content, postId: post.id },
+      optimistic: {
+        author: user
+          ? {
+              id: user.id,
+              name: user.name ?? 'Anonymous',
+            }
+          : null,
+        content,
+        id: `optimistic:${Date.now().toString(36)}`,
+        post: { commentCount: post.commentCount + 1, id: post.id },
+      },
+      view: view<InlineComment>()({
+        ...CommentView,
+        post: { commentCount: true },
+      }),
+    });
+
+    setCommentText('');
+
+    return result;
+  }, null);
+
+  const maybeSubmitComment = (event: KeyboardEvent<HTMLTextAreaElement>) => {
+    if (event.key === 'Enter' && (event.ctrlKey || event.metaKey)) {
+      startTransition(() => handleAddComment());
+    }
+  };
+
+  const commentingIsDisabled = addCommentIsPending || commentText.trim().length === 0;
+
+  const anyServerError = error || addCommentResult?.error;
+
+  return (
+    <VStack action={handleAddComment} as="form" gap>
+      <span className="text-sm font-medium text-foreground">
+        <fbt desc="Comment add label">Add a comment</fbt>
+      </span>
+      <textarea
+        className="squircle min-h-20 w-full border border-gray-200/80 bg-gray-100/50 p-3 text-sm placeholder-gray-500 transition outline-none focus:border-gray-500 focus:ring-2 focus:ring-gray-200 disabled:opacity-50 dark:border-neutral-800 dark:bg-neutral-900/40 dark:placeholder-gray-400"
+        disabled={addCommentIsPending}
+        onChange={(event) => setCommentText(event.target.value)}
+        onKeyDown={maybeSubmitComment}
+        placeholder={fbs('Share your thoughts...', 'Placeholder text for comment input')}
+        value={commentText}
+      />
+      {anyServerError ? (
+        <p className="text-sm text-destructive">
+          {anyServerError instanceof Error ? (
+            anyServerError.message
+          ) : (
+            <fbt desc="Error text">Something went wrong. Please try again.</fbt>
+          )}
+        </p>
+      ) : null}
+      <Stack end gap>
+        <Button disabled={commentingIsDisabled} size="sm" type="submit" variant="secondary">
+          <fbt desc="Post comment button">Post comment</fbt>
+        </Button>
+      </Stack>
+    </VStack>
+  );
+};
+
+export function PostCard({ detail, post: postRef }: { detail?: boolean; post: ViewRef<'Post'> }) {
+  const fate = useFateClient();
+  const post = useView(PostView, postRef);
+  const author = useView(UserView, post.author);
+
+  const [likeResult, likeAction, likeIsPending] = useActionState(fate.actions.post.like, null);
+
+  const [, unlikeAction, unlikeIsPending] = useActionState(fate.actions.post.unlike, null);
+
+  useEffect(() => {
+    if (likeResult?.error) {
+      const timeout = setTimeout(() => startTransition(() => likeAction('reset')), 3000);
+      return () => clearTimeout(timeout);
+    }
+  }, [likeAction, likeResult]);
+
+  const handleLike = useCallback(
+    async (options?: { error?: 'boundary' | 'callSite'; slow?: boolean }) => {
+      likeAction({
+        input: { id: post.id, ...options },
+        optimistic: { likes: post.likes + 1 },
+        view: PostView,
+      });
+    },
+    [likeAction, post.id, post.likes],
+  );
+
+  const handleUnlike = useCallback(async () => {
+    unlikeAction({
+      input: { id: post.id },
+      optimistic: {
+        likes: Math.max(post.likes - 1, 0),
+      },
+      view: PostView,
+    });
+  }, [post.id, post.likes, unlikeAction]);
+
+  return (
+    <Card>
+      <VStack gap={16}>
+        <Stack alignStart between gap={16} wrap>
+          <VStack gap>
+            <Link to={`/post/${post.id}`}>
+              <H3>{post.title}</H3>
+            </Link>
+          </VStack>
+          <Stack alignCenter gap={12} wrap>
+            <Stack
+              alignCenter
+              className="squircle bg-slate-100 px-3 py-2 text-sm font-semibold text-slate-800 dark:bg-neutral-800 dark:text-white"
+              gap
+            >
+              <span>👍</span>
+              <span>
+                <fbt desc="Like count">
+                  <fbt:plural count={post.likes} many="Likes" showCount="yes">
+                    Like
+                  </fbt:plural>
+                </fbt>
+              </span>
+            </Stack>
+            <Button action={handleLike} disabled={likeIsPending} size="sm" variant="outline">
+              <fbt desc="Like button">Like</fbt>
+            </Button>
+            {detail && (
+              <Button
+                action={() => handleLike({ slow: true })}
+                disabled={likeIsPending}
+                size="sm"
+                variant="outline"
+              >
+                <fbt desc="Like button with a slow request">Like (Slow)</fbt>
+              </Button>
+            )}
+            {detail && (
+              <Button
+                action={() => handleLike({ error: 'callSite' })}
+                className={cx(
+                  'w-32 transition-colors duration-150',
+                  likeResult?.error ? 'border-red-500 text-red-500 hover:text-red-500' : '',
+                )}
+                disabled={likeIsPending}
+                size="sm"
+                variant="outline"
+              >
+                {likeResult?.error ? (
+                  <fbt desc="Very short error messages">Oops, try again!</fbt>
+                ) : (
+                  <fbt desc="Like button that triggers an error">Like (Error)</fbt>
+                )}
+              </Button>
+            )}
+            {detail && (
+              <Button
+                action={() => handleLike({ error: 'boundary' })}
+                disabled={likeIsPending}
+                size="sm"
+                variant="outline"
+              >
+                <fbt desc="Like button that triggers a network error">Like (Network Error)</fbt>
+              </Button>
+            )}
+            {detail && (
+              <Button
+                onClick={() =>
+                  fate.mutations.post.like({
+                    input: { id: post.id },
+                    optimistic: { likes: post.likes + 1 },
+                    view: PostView,
+                  })
+                }
+                size="sm"
+                variant="outline"
+              >
+                <fbt desc="Like button that can be pressed many times">Like (Many)</fbt>
+              </Button>
+            )}
+            <Button
+              action={handleUnlike}
+              disabled={unlikeIsPending || post.likes === 0}
+              size="sm"
+              variant="outline"
+            >
+              <fbt desc="Unlike button">Unlike</fbt>
+            </Button>
+          </Stack>
+        </Stack>
+        <p className="text-sm leading-relaxed text-foreground/90 lg:text-base">{post.content}</p>
+        <p className="text-sm text-muted-foreground">- {author?.name ?? 'Unknown author'}</p>
+        <VStack gap={16}>
+          <h4 className="text-base font-semibold text-foreground">
+            <fbt desc="Comment headline">
+              <fbt:plural count={post.commentCount} many="Comments" showCount="ifMany">
+                One Comment
+              </fbt:plural>
+            </fbt>
+          </h4>
+          <Suspense fallback={null}>
+            <PostComments comments={post.comments} post={post} />
+          </Suspense>
+          <ErrorBoundary fallbackRender={({ error }) => <CommentInput error={error} post={post} />}>
+            <CommentInput post={post} />
+          </ErrorBoundary>
+        </VStack>
+      </VStack>
+    </Card>
+  );
+}

package/templates/fate/cloudflare/client/src/ui/Section.tsx

@@ -0,0 +1,23 @@
+import { Gap, VStack } from '@nkzw/stack';
+import { ReactNode } from 'react';
+import cx from '../lib/cx.tsx';
+
+export default function Section({
+  children,
+  className,
+  gap,
+}: {
+  children: ReactNode;
+  className?: string;
+  gap?: Gap;
+}) {
+  return (
+    <VStack
+      as="section"
+      className={cx('max-w-8xl container mx-auto px-4 py-6 lg:px-8 lg:py-10', className)}
+      gap={gap}
+    >
+      {children}
+    </VStack>
+  );
+}

package/templates/fate/cloudflare/client/src/ui/UserCard.tsx

@@ -0,0 +1,131 @@
+import { User } from '@app/server/src/router.ts';
+import safeParse from '@nkzw/core/safeParse.js';
+import Stack, { VStack } from '@nkzw/stack';
+import { fbs } from 'fbtee';
+import { ChangeEvent, useActionState, useState } from 'react';
+import { view } from 'react-fate';
+import { useFateClient } from 'react-fate';
+import { ViewRef } from 'react-fate';
+import { useView } from 'react-fate';
+import { Button } from '../ui/Button.tsx';
+import Card from '../ui/Card.tsx';
+import AuthClient from '../user/AuthClient.tsx';
+import H2 from './H2.tsx';
+import Input from './Input.tsx';
+
+export type SessionUser = {
+  id?: string | null;
+  name?: string | null;
+  username?: string | null;
+};
+
+export const UserView = view<User>()({
+  id: true,
+  name: true,
+  username: true,
+});
+
+const UserNameForm = ({ user }: { user: SessionUser }) => {
+  const fate = useFateClient();
+  const [name, setName] = useState(user.name ?? '');
+  const [error, setError] = useState<string | null>(null);
+
+  const handleChange = (event: ChangeEvent<HTMLInputElement>) => {
+    setError(null);
+    setName(event.target.value);
+  };
+
+  const [, submitAction, isPending] = useActionState(async () => {
+    const id = user?.id;
+    if (!id) {
+      return;
+    }
+
+    const newName = name.trim();
+    setName(newName);
+
+    if (newName === user.name) {
+      setError(null);
+      return;
+    }
+
+    try {
+      setError(null);
+      await fate.mutations.user.update({
+        input: { name: newName },
+        optimistic: {
+          id,
+          username: newName,
+        },
+        view: UserView,
+      });
+      await AuthClient.updateUser({ name });
+    } catch (error) {
+      setError(
+        (error instanceof Error &&
+          error.message &&
+          safeParse<Array<{ message: string }>>(error.message)?.[0]?.message) ||
+          'Failed to update user name.',
+      );
+    }
+  }, null);
+
+  const trimmedName = name.trim();
+  const originalName = user.name ?? '';
+  const isSaveDisabled = !user.id || !trimmedName || trimmedName === originalName || isPending;
+
+  return (
+    <div>
+      <VStack action={submitAction} as="form" gap={12}>
+        <h3 className="font-semibold">
+          <fbt desc="Headline for update name section">Update Name</fbt>
+        </h3>
+        <label className="sr-only" htmlFor="header-username">
+          <fbt desc="Username label">Username</fbt>
+        </label>
+        <Input
+          aria-describedby={error ? 'header-username-error' : undefined}
+          aria-invalid={error ? 'true' : undefined}
+          className="w-48"
+          disabled={isPending}
+          id="header-username"
+          name="name"
+          onChange={handleChange}
+          placeholder={fbs('name', 'name input field placeholder')}
+          title={error ?? undefined}
+          value={name}
+        />
+        <div>
+          <Button disabled={isSaveDisabled} size="sm" type="submit" variant="secondary">
+            <fbt desc="Button for saving">Save</fbt>
+          </Button>
+        </div>
+      </VStack>
+      {error ? <span id="header-username-error">{error}</span> : null}
+    </div>
+  );
+};
+
+export default function UserCard({ user: userRef }: { user: ViewRef<'User'> }) {
+  const user = useView(UserView, userRef);
+
+  return (
+    <Card>
+      <VStack between className="h-full" gap={16}>
+        <VStack gap={16}>
+          <H2>
+            <fbt desc="Your account headline">Your account</fbt>
+          </H2>
+          <Stack alignCenter between gap={16}>
+            <p className="text-sm text-muted-foreground">
+              <fbt desc="Signed in text">
+                Signed in as <fbt:param name="username">{user.name}</fbt:param>.
+              </fbt>
+            </p>
+          </Stack>
+        </VStack>
+        <UserNameForm user={user} />
+      </VStack>
+    </Card>
+  );
+}

package/templates/fate/cloudflare/client/src/user/AuthClient.tsx

@@ -0,0 +1,6 @@
+import { createAuthClient } from 'better-auth/react';
+import env from '../lib/env.tsx';
+
+export default createAuthClient({
+  baseURL: env('SERVER_URL'),
+});