` - The Stack client app instance.
+
+## Example
+
+```tsx
+import { StackProvider } from '@stackframe/stack';
+import { app } from './stackApp';
+
+function App() {
+ return (
+
+
+
+ );
+}
+```
\ No newline at end of file
diff --git a/docs/fern/docs/pages/sdk/stack-theme.mdx b/docs/fern/docs/pages/sdk/stack-theme.mdx
new file mode 100644
index 0000000000..89d1ee87fd
--- /dev/null
+++ b/docs/fern/docs/pages/sdk/stack-theme.mdx
@@ -0,0 +1,32 @@
+---
+title: StackTheme
+---
+
+# StackTheme
+
+A component to apply a custom theme to your Stack application. It wraps your app and provides theme context.
+
+## Parameters
+
+- `theme` (optional): `ThemeConfig` - Custom theme configuration to override default values.
+- `children` (optional): `React.ReactNode` - Child components to be wrapped by the theme provider.
+- `nonce` (optional): `string` - A nonce for the inline script and style tags for added security.
+
+## Example
+
+```tsx
+import { StackTheme } from '@stackframe/stack';
+
+function App() {
+ const customTheme = {
+ light: { backgroundColor: '#f0f0f0' },
+ dark: { backgroundColor: '#1a1a1a' }
+ };
+
+ return (
+
+
+
+ );
+}
+```
\ No newline at end of file
diff --git a/docs/fern/docs/pages/sdk/use-stack-app.mdx b/docs/fern/docs/pages/sdk/use-stack-app.mdx
index 19c9965186..7919820caa 100644
--- a/docs/fern/docs/pages/sdk/use-stack-app.mdx
+++ b/docs/fern/docs/pages/sdk/use-stack-app.mdx
@@ -1,16 +1,27 @@
---
-slug: sdk/use-stack-app
+title: useStackApp
---
-The `useStackApp` hook returns the `StackClientApp` object that you can use to interact with the Stack API. If you want to learn more about the `StackClientApp` object, check out the [App](./stack-app.mdx) documentation.
+# useStackApp
-Example:
+A React hook that returns the StackClientApp instance within a StackProvider context.
-```jsx
-import { useStackApp } from "@stackframe/stack";
+## Parameters
-function MyComponent() {
- const stackApp = useStackApp();
- return Sign In URL: {stackApp.urls.signIn}
;
-}
+- `options` (optional): An object with the following property:
+ - `projectIdMustMatch` (optional): `ProjectId` - A string type parameter to enforce a specific project ID.
+
+## Example
+
+```tsx
+import { useStackApp } from '@stackframe/stack';
+
+// Basic usage
+const app = useStackApp();
+
+// With project ID enforcement
+const app = useStackApp<'my-project-id'>({ projectIdMustMatch: 'my-project-id' });
+
+// Use the app
+const result = app.someMethod();
```
\ No newline at end of file
diff --git a/docs/fern/docs/pages/sdk/use-user.mdx b/docs/fern/docs/pages/sdk/use-user.mdx
index f64d84cd3b..8fdadb1ee0 100644
--- a/docs/fern/docs/pages/sdk/use-user.mdx
+++ b/docs/fern/docs/pages/sdk/use-user.mdx
@@ -1,34 +1,37 @@
---
-slug: sdk/use-user
+title: useUser
---
-`useUser` is a hook that returns the user object if the user is authenticated; otherwise, it returns `null` by default. However, if you pass in `{ or: "redirect" }` or `{ or: "throw" }` as an option, it will redirect to the login page or throw an error respectively when the user is not authenticated.
+# useUser
-If you want to learn more about the `User` object, check out the [User](./current-user.mdx) documentation.
+A hook to retrieve the current user information with various options for handling authentication and project matching.
-## Default Usage
+## Parameters
-Check if the user is authenticated and display the user's name.
-```jsx
-import { useUser } from "@stackframe/stack";
+- `options` (optional): `GetUserOptions` - Options for retrieving user information.
+ - `or` (optional): `'redirect' | 'throw'` - Specifies behavior if user is not authenticated.
+ - `projectIdMustMatch` (optional): `'internal'` - Ensures the user belongs to an internal project.
-function MyComponent() {
- const user = useUser(); // user can be null
- if (!user) {
- return Not authenticated
;
- }
- return Hello, {user.name}
;
-}
-```
+## Example
-## Redirect when not authenticated
-By passing `{ or: "redirect" }` to the hook, it will redirect to the login page if the user is not authenticated. You can configure the login page in the StackApp component.
-```jsx
-import { useUser } from "@stackframe/stack";
+```tsx
+import { useUser } from '@stackframe/stack';
-function MyComponent() {
- const user = useUser({ or: "redirect" }); // user is garanteed to be non-null
- return Hello, {user.name}
;
+// Basic usage
+const user = useUser();
+
+// With options
+const internalUser = useUser({ projectIdMustMatch: 'internal' });
+
+// With authentication handling
+const authenticatedUser = useUser({ or: 'redirect' });
+
+// Combined options
+const authenticatedInternalUser = useUser({
+ or: 'throw',
+ projectIdMustMatch: 'internal'
+});
+``` return Hello, {user.name}
;
}
```
diff --git a/docs/fern/docs/pages/sdk/user-button.mdx b/docs/fern/docs/pages/sdk/user-button.mdx
new file mode 100644
index 0000000000..440d94a6a3
--- /dev/null
+++ b/docs/fern/docs/pages/sdk/user-button.mdx
@@ -0,0 +1,26 @@
+---
+title: UserButton
+---
+
+# UserButton
+
+Renders a user button component with a loading state.
+
+## Parameters
+
+- `props`: `UserButtonProps` - Properties for configuring the UserButton component.
+
+## Example
+
+```tsx
+import { UserButton } from '@stackframe/stack';
+
+function MyComponent() {
+ return ;
+}
+
+// With custom properties
+function CustomizedUserButton() {
+ return ;
+}
+```
\ No newline at end of file