raystack · rohanchkrabrty · Apr 6, 2026 · Mar 24, 2026 · Mar 26, 2026 · Mar 27, 2026
diff --git a/web/apps/client-demo/src/Router.tsx b/web/apps/client-demo/src/Router.tsx
@@ -10,6 +10,7 @@ import Organization from './pages/Organization';
 import Settings from './pages/Settings';
 import General from './pages/settings/General';
 import Preferences from './pages/settings/Preferences';
+import Profile from './pages/settings/Profile';
 
 function Router() {
   return (
@@ -26,6 +27,7 @@ function Router() {
         <Route path="/:orgId/settings" element={<Settings />}>
           <Route path="general" element={<General />} />
           <Route path="preferences" element={<Preferences />} />
+          <Route path="profile" element={<Profile />} />
         </Route>
         <Route path="*" element={<Navigate to="/" replace />} />
       </Routes>

diff --git a/web/apps/client-demo/src/pages/Settings.tsx b/web/apps/client-demo/src/pages/Settings.tsx
@@ -5,7 +5,8 @@ import { useFrontier } from '@raystack/frontier/react';
 
 const NAV_ITEMS = [
   { label: 'General', path: 'general' },
-  { label: 'Preferences', path: 'preferences' }
+  { label: 'Preferences', path: 'preferences' },
+  { label: 'Profile', path: 'profile' }
 ];
 
 export default function Settings() {

diff --git a/web/apps/client-demo/src/pages/settings/Profile.tsx b/web/apps/client-demo/src/pages/settings/Profile.tsx
@@ -0,0 +1,5 @@
+import { ProfileView } from '@raystack/frontier/react';
+
+export default function Profile() {
+  return <ProfileView />;
+}
diff --git a/web/sdk/package.json b/web/sdk/package.json
@@ -107,6 +107,8 @@
     "@tanstack/react-query": "^5.90.2",
     "@tanstack/react-router": "^1.168.3",
     "axios": "^1.9.0",
+    "@raystack/apsara-v1": "npm:@raystack/apsara@1.0.0-rc.1",
+    "@base-ui/react": "1.2.0",
     "class-variance-authority": "^0.7.1",
     "dayjs": "^1.11.13",
     "lodash": "^4.17.21",

diff --git a/web/sdk/react/index.ts b/web/sdk/react/index.ts
@@ -32,6 +32,7 @@ export { ViewContainer } from './components/view-container';
 export { ViewHeader } from './components/view-header';
 export { GeneralView } from './views-new/general';
 export { PreferencesView, PreferenceRow } from './views-new/preferences';
+export { ProfileView } from './views-new/profile';
 
 export type {
   FrontierClientOptions,

diff --git a/web/sdk/react/views-new/profile/index.ts b/web/sdk/react/views-new/profile/index.ts
@@ -0,0 +1 @@
+export { ProfileView } from './profile-view';
diff --git a/web/sdk/react/views-new/profile/profile-view.module.css b/web/sdk/react/views-new/profile/profile-view.module.css
@@ -0,0 +1,8 @@
+.section {
+  padding: var(--rs-space-9) 0;
+  border-bottom: 1px solid var(--rs-color-border-base-primary);
+}
+
+.formFields {
+  max-width: 320px;
+}
diff --git a/web/sdk/react/views-new/profile/profile-view.tsx b/web/sdk/react/views-new/profile/profile-view.tsx
@@ -0,0 +1,185 @@
+'use client';
+
+import { useEffect } from 'react';
+import { yupResolver } from '@hookform/resolvers/yup';
+import { useForm } from 'react-hook-form';
+import * as yup from 'yup';
+import {
+  createConnectQueryKey,
+  useMutation
+} from '@connectrpc/connect-query';
+import { FrontierServiceQueries } from '@raystack/proton/frontier';
+import { useQueryClient } from '@tanstack/react-query';
+import {
+  Button,
+  Flex,
+  InputField,
+  Skeleton,
+  toastManager
+} from '@raystack/apsara-v1';
+import { useFrontier } from '../../contexts/FrontierContext';
+import { ViewContainer } from '../../components/view-container';
+import { ViewHeader } from '../../components/view-header';
+import { ImageUpload } from '../../components/image-upload';
+import styles from './profile-view.module.css';
+
+const profileSchema = yup
+  .object({
+    avatar: yup.string().optional(),
+    title: yup
+      .string()
+      .required('Name is required')
+      .min(2, 'Name must be at least 2 characters')
+      .matches(
+        /^[\p{L} .'-]+$/u,
+        'Name can only contain letters, spaces, periods, hyphens, and apostrophes'
+      )
+      .matches(/^\p{L}/u, 'Name must start with a letter')
+      .matches(
+        /^\p{L}[\p{L} .'-]*\p{L}$|^\p{L}$/u,
+        'Name must end with a letter'
+      )
+      .matches(/^(?!.* {2}).*$/, 'Name cannot have consecutive spaces')
+      .matches(/^(?!.* [^\p{L}]).*$/u, 'Spaces must be followed by a letter')
+      .matches(/^(?!.*-[^\p{L}]).*$/u, 'Hyphens must be followed by a letter')
+      .matches(
+        /^(?!.*'[^\p{L}]).*$/u,
+        'Apostrophes must be followed by a letter'
+      ),
+    email: yup.string().email().required()
+  })
+  .required();
+
+type FormData = yup.InferType<typeof profileSchema>;
+
+export function ProfileView() {
+  const { user, isUserLoading: isLoading } = useFrontier();
+  const queryClient = useQueryClient();
+
+  const { mutateAsync: updateCurrentUser } = useMutation(
+    FrontierServiceQueries.updateCurrentUser,
+    {
+      onSuccess: () => {
+        queryClient.invalidateQueries({
+          queryKey: createConnectQueryKey({
+            schema: FrontierServiceQueries.getCurrentUser,
+            cardinality: 'finite'
+          })
+        });
+      }
+    }
+  );
+
+  const {
+    reset,
+    register,
+    handleSubmit,
+    watch,
+    setValue,
+    formState: { errors, isSubmitting, isDirty }
+  } = useForm({
+    resolver: yupResolver(profileSchema)
+  });
+
+  useEffect(() => {
+    reset(user, { keepDirtyValues: true });
+  }, [user, reset]);
+
+  async function onSubmit(data: FormData) {
+    try {
+      if (!user?.id) return;
+      await updateCurrentUser({ body: data });
+      toastManager.add({ title: 'Updated user', type: 'success' });
+    } catch (err: unknown) {
+      toastManager.add({
+        title: 'Something went wrong',
+        description: err instanceof Error ? err.message : 'Failed to update',
+        type: 'error'
+      });
+    }
+  }
+
+  return (
+    <ViewContainer>
+      <ViewHeader
+        title="Profile"
+        description="Manage your profile information and settings."
+      />
+
+      <form onSubmit={handleSubmit(onSubmit)}>
+        <Flex direction="column">
+          {/* Avatar section */}
+          <Flex direction="column" gap={5} className={styles.section}>
+            {isLoading ? (
+              <Flex direction="column" gap={5}>
+                <Skeleton width="72px" height="72px" />
+                <Skeleton height="20px" width="50%" />
+              </Flex>
+            ) : (
+              <ImageUpload
+                value={watch('avatar')}
+                onChange={(value: string) =>
+                  setValue('avatar', value, { shouldDirty: true })
+                }
+                description="Pick a profile picture for your avatar. Max size: 5 Mb"
+                initials={user?.title?.[0]}
+                data-test-id="frontier-sdk-profile-avatar-upload"
+              />
+            )}
+          </Flex>
+
+          {/* Form section */}
+          <Flex direction="column" gap={7} className={styles.section}>
+            <Flex direction="column" gap={9} className={styles.formFields}>
+              {isLoading ? (
+                <>
+                  <Skeleton height="58px" />
+                  <Skeleton height="58px" />
+                </>
+              ) : (
+                <>
+                  <InputField
+                    label="Full name"
+                    size="large"
+                    error={errors.title && String(errors.title?.message)}
+                    defaultValue={user?.title || ''}
+                    placeholder="Provide full name"
+                    {...register('title')}
+                    disabled={isLoading}
+                  />
+                  <InputField
+                    label="Email address"
+                    size="large"
+                    error={errors.email && String(errors.email?.message)}
+                    value={user?.email || ''}
+                    type="email"
+                    placeholder="Provide email address"
+                    {...register('email')}
+                    readOnly
+                    disabled
+                  />
+                </>
+              )}
+            </Flex>
+
+            {isLoading ? (
+              <Skeleton height="32px" width="64px" />
+            ) : (
+              <Button
+                type="submit"
+                variant="solid"
+                color="accent"
+                disabled={isLoading || isSubmitting || !isDirty}
+                loading={isSubmitting}
+                loaderText="Updating..."
+                data-test-id="frontier-sdk-update-user-btn"
+              >
+                Update
+              </Button>
+            )}
+          </Flex>
+        </Flex>
+      </form>
+    </ViewContainer>
+  );
+}