# Registration

Canonical page: https://docs.ovok.com/native-sdk/guide/components/auth/register

Use `Register` to compose an account-creation screen. Its default email flow
submits to the active native `Ovok` client, activates the returned login, and publishes
a session change. Your app owns the next route and any onboarding that follows.

## Add a registration screen [#add-a-registration-screen]

Render the screen below [`OvokProvider`](/native-sdk/guide/how-to/app-shell) and the SDK
`ThemeProvider`. Pass a tenant code from public app configuration.

```tsx
import { Register } from "@ovok/native";
import { useRouter } from "expo-router";
import { Alert } from "react-native";

export function RegisterScreen() {
  const router = useRouter();
  const tenantCode = process.env.EXPO_PUBLIC_TENANT_CODE;

  if (!tenantCode) {
    throw new Error("Set EXPO_PUBLIC_TENANT_CODE for this app environment");
  }

  return (
    <Register>
      <Register.Header>
        <Register.Header.Title />
        <Register.Header.Description />
      </Register.Header>

      <Register.EmailForm
        tenantCode={tenantCode}
        onSuccess={() => router.replace("/welcome")}
        onError={() =>
          Alert.alert("Registration failed", "Review your details or try again.")
        }
      >
        <Register.EmailForm.Inputs />
        <Register.EmailForm.RegisterButton />
      </Register.EmailForm>

      <Register.LoginLink onPress={() => router.push("/sign-in")} />
    </Register>
  );
}
```

Change the paths to match your navigation. The default form collects name,
surname, email, password, and password confirmation. `defaultValues` can prefill
fields when your flow already knows some of those values.

## Customize validation or submission [#customize-validation-or-submission]

Pass `customValidations` to extend the built-in Yup validation. Use `onSubmit`
when your app owns registration; it replaces the SDK's default `client.auth.register`
request and automatic active-login setup. In that mode, handle errors, session
updates, and navigation in your implementation. `onSubmit` cannot be combined
with the default-flow `onSuccess` and `onError` callbacks.

The shared Google and Apple buttons are available through
`Register.SocialLogins`. Configure the native provider packages before
rendering them; see [installation](/native-sdk/guide/how-to/installation) and the
[registration examples](/native-sdk/guide/components/auth/register/examples/basic-usage).

## Related references [#related-references]

- [Registration form and props](/native-sdk/guide/components/auth/register/components/form/)
- [Inputs](/native-sdk/guide/components/auth/register/components/form/inputs) and [submit button](/native-sdk/guide/components/auth/register/components/form/register-button)
- [Authentication integration guide](/native-sdk/guide/modules/auth)