Skip to content

Add decorateUrl to navigate callbacks for Safari ITP support #3037

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
nikosdouvlis merged 11 commits into from
Feb 10, 2026
Merged

Add decorateUrl to navigate callbacks for Safari ITP support #3037

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
11 commits
Select commit Hold shift + click to select a range
c13bee6
feat(docs): add decorateUrl to navigate callbacks for Safari ITP support
nikosdouvlis Feb 4, 2026
c7a70ee
docs review
alexisintech Feb 6, 2026
a9f781e
Merge branch 'core-3' into nikos/user4475-udpate-docs-with-decorateurl
alexisintech Feb 6, 2026
99eb5e3
fix(docs): use object destructuring for decorateUrl in navigate callb…
nikosdouvlis Feb 9, 2026
b122f5a
Next.js: Remove beforeYouStart from quickstart hero (#3058)
manovotny Feb 9, 2026
b09a061
Merge remote-tracking branch 'origin/main' into nikos/user4475-udpate…
nikosdouvlis Feb 10, 2026
93d3db5
fix(docs): fix decorateUrl bugs in navigate callback examples
nikosdouvlis Feb 10, 2026
183ee86
Merge remote-tracking branch 'origin/core-3' into nikos/user4475-udpa…
nikosdouvlis Feb 10, 2026
6cd9ca2
fix merge commit
alexisintech Feb 10, 2026
c7cb0cc
final update
alexisintech Feb 10, 2026
121465f
fix link
alexisintech Feb 10, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 4 additions & 4 deletions docs/_partials/expo/email-pass-sign-in.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -27,8 +27,8 @@ export default function Page() {

if (signIn.status === 'complete') {
await signIn.finalize({
navigate: () => {
router.push('/')
navigate: ({ decorateUrl }) => {
router.push(decorateUrl('/'))
},
})
}
Expand All @@ -44,8 +44,8 @@ export default function Page() {

if (signIn.status === 'complete') {
await signIn.finalize({
navigate: () => {
router.push('/')
navigate: ({ decorateUrl }) => {
router.push(decorateUrl('/'))
},
})
}
Expand Down
4 changes: 2 additions & 2 deletions docs/_partials/expo/email-pass-sign-up.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -35,8 +35,8 @@ export default function Page() {

if (signUp.status === 'complete') {
await signUp.finalize({
navigate: () => {
router.push('/')
navigate: ({ decorateUrl }) => {
router.push(decorateUrl('/'))
},
})
}
Expand Down
7 changes: 0 additions & 7 deletions docs/getting-started/quickstart.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -14,13 +14,6 @@ llm:
link: "https://github.com/clerk/clerk-nextjs-app-quickstart"
}
]}
beforeYouStart={[
{
title: "Set up a Clerk application",
link: "/docs/getting-started/quickstart/setup-clerk",
icon: "clerk",
},
]}
/>

<Steps>
Expand Down
18 changes: 14 additions & 4 deletions docs/guides/development/custom-flows/account-updates/forgot-password.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -92,15 +92,20 @@ This guide demonstrates how to use Clerk's API to build a custom flow for resett
// the newly created session (user is now signed in)
setActive({
session: result.createdSessionId,
navigate: async ({ session }) => {
navigate: async ({ session, decorateUrl }) => {
if (session?.currentTask) {
// Check for tasks and navigate to custom UI to help users resolve them
// See https://clerk.com/docs/guides/development/custom-flows/authentication/session-tasks
console.log(session?.currentTask)
return
}

router.push('/')
const url = decorateUrl('/')
if (url.startsWith('http')) {
window.location.href = url
} else {
router.push(url)
}
},
})
setError('')
Expand Down Expand Up @@ -502,15 +507,20 @@ In this case, you can prompt the user to reset their password using the exact sa
// the newly created session (user is now signed in)
setActive({
session: result.createdSessionId,
navigate: async ({ session }) => {
navigate: async ({ session, decorateUrl }) => {
if (session?.currentTask) {
// Check for tasks and navigate to custom UI to help users resolve them
// See https://clerk.com/docs/guides/development/custom-flows/authentication/session-tasks
console.log(session?.currentTask)
return
}

router.push('/')
const url = decorateUrl('/')
if (url.startsWith('http')) {
window.location.href = url
} else {
router.push(url)
}
},
})
setError('')
Expand Down
9 changes: 7 additions & 2 deletions docs/guides/development/custom-flows/authentication/application-invitations.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -60,8 +60,13 @@ To create a sign-up flow using the invitation token, you need to call the [`sign
})
if (signUp.status === 'complete') {
await signUp.finalize({
navigate: () => {
router.push('/')
navigate: ({ decorateUrl }) => {
const url = decorateUrl('/')
if (url.startsWith('http')) {
window.location.href = url
} else {
router.push(url)
}
},
})
}
Expand Down
27 changes: 21 additions & 6 deletions docs/guides/development/custom-flows/authentication/email-password-mfa.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -82,8 +82,13 @@ This guide will walk you through how to build a custom email/password sign-in fl
})
if (signIn.status === 'complete') {
await signIn.finalize({
navigate: () => {
router.push('/')
navigate: ({ decorateUrl }) => {
const url = decorateUrl('/')
if (url.startsWith('http')) {
window.location.href = url
} else {
router.push(url)
}
},
})
}
Expand All @@ -101,8 +106,13 @@ This guide will walk you through how to build a custom email/password sign-in fl

if (signIn.status === 'complete') {
await signIn.finalize({
navigate: () => {
router.push('/')
navigate: ({ decorateUrl }) => {
const url = decorateUrl('/')
if (url.startsWith('http')) {
window.location.href = url
} else {
router.push(url)
}
},
})
}
Expand Down Expand Up @@ -204,8 +214,13 @@ This guide will walk you through how to build a custom email/password sign-in fl

if (signIn.status === 'complete') {
await signIn.finalize({
navigate: () => {
router.push('/')
navigate: ({ decorateUrl }) => {
const url = decorateUrl('/')
if (url.startsWith('http')) {
window.location.href = url
} else {
router.push(url)
}
},
})
}
Expand Down
27 changes: 21 additions & 6 deletions docs/guides/development/custom-flows/authentication/email-password.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -76,8 +76,13 @@ This guide will walk you through how to build a custom email/password sign-up an
})
if (signUp.status === 'complete') {
await signUp.finalize({
navigate: () => {
router.push('/dashboard')
navigate: ({ decorateUrl }) => {
const url = decorateUrl('/dashboard')
if (url.startsWith('http')) {
window.location.href = url
} else {
router.push(url)
}
},
})
}
Expand Down Expand Up @@ -395,8 +400,13 @@ This guide will walk you through how to build a custom email/password sign-up an
})
if (signIn.status === 'complete') {
await signIn.finalize({
navigate: () => {
router.push('/')
navigate: ({ decorateUrl }) => {
const url = decorateUrl('/')
if (url.startsWith('http')) {
window.location.href = url
} else {
router.push(url)
}
},
})
}
Expand All @@ -414,8 +424,13 @@ This guide will walk you through how to build a custom email/password sign-up an

if (signIn.status === 'complete') {
await signIn.finalize({
navigate: () => {
router.push('/')
navigate: ({ decorateUrl }) => {
const url = decorateUrl('/')
if (url.startsWith('http')) {
window.location.href = url
} else {
router.push(url)
}
},
})
}
Expand Down
18 changes: 14 additions & 4 deletions docs/guides/development/custom-flows/authentication/email-sms-otp.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -71,8 +71,13 @@ This guide will walk you through how to build a custom SMS OTP sign-up and sign-
await signUp.verifications.verifyPhoneCode({ code })
if (signUp.status === 'complete') {
await signUp.finalize({
navigate: () => {
router.push('/dashboard')
navigate: ({ decorateUrl }) => {
const url = decorateUrl('/dashboard')
if (url.startsWith('http')) {
window.location.href = url
} else {
router.push(url)
}
},
})
}
Expand Down Expand Up @@ -388,8 +393,13 @@ This guide will walk you through how to build a custom SMS OTP sign-up and sign-
await signIn.phoneCode.verifyCode({ code })
if (signIn.status === 'complete') {
await signIn.finalize({
navigate: () => {
router.push('/')
navigate: ({ decorateUrl }) => {
const url = decorateUrl('/')
if (url.startsWith('http')) {
window.location.href = url
} else {
router.push(url)
}
},
})
}
Expand Down
18 changes: 14 additions & 4 deletions docs/guides/development/custom-flows/authentication/embedded-email-links.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -88,13 +88,18 @@ This guide will demonstrate how to generate a sign-in token and use it to sign i
// If the sign-in was successful, set the session to active
if (signIn.status === 'complete') {
signIn.finalize({
navigate: async ({ session }) => {
navigate: async ({ session, decorateUrl }) => {
if (session?.currentTask) {
console.log(session?.currentTask)
return
}

router.push('/')
const url = decorateUrl('/')
if (url.startsWith('http')) {
window.location.href = url
} else {
router.push(url)
}
},
})
} else {
Expand Down Expand Up @@ -170,13 +175,18 @@ This guide will demonstrate how to generate a sign-in token and use it to sign i
// If the sign-in was successful, set the session to active
if (signIn.status === 'complete') {
signIn.finalize({
navigate: async ({ session }) => {
navigate: async ({ session, decorateUrl }) => {
if (session?.currentTask) {
console.log(session?.currentTask)
return
}

router.push('/')
const url = decorateUrl('/')
if (url.startsWith('http')) {
window.location.href = url
} else {
router.push(url)
}
},
})
}
Expand Down
9 changes: 7 additions & 2 deletions docs/guides/development/custom-flows/authentication/enterprise-connections.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -118,15 +118,20 @@ You must configure your application instance through the Clerk Dashboard for the
if (createdSessionId) {
setActive!({
session: createdSessionId,
navigate: async ({ session }) => {
navigate: async ({ session, decorateUrl }) => {
if (session?.currentTask) {
// Check for tasks and navigate to custom UI to help users resolve them
// See https://clerk.com/docs/guides/development/custom-flows/authentication/session-tasks
console.log(session?.currentTask)
return
}

router.push('/')
const url = decorateUrl('/')
if (url.startsWith('http')) {
window.location.href = url
} else {
router.push(url)
}
},
})
} else {
Expand Down
9 changes: 7 additions & 2 deletions ...ides/development/custom-flows/authentication/legacy/application-invitations.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -228,15 +228,20 @@ To create a sign-up flow using the invitation token, you need to extract the tok
if (signUpAttempt.status === 'complete') {
await clerk.setActive({
session: signUpAttempt.createdSessionId,
navigate: async ({ session }) => {
navigate: async ({ session, decorateUrl }) => {
if (session?.currentTask) {
// Check for tasks and navigate to custom UI to help users resolve them
// See https://clerk.com/docs/guides/development/custom-flows/authentication/session-tasks
console.log(session?.currentTask)
return
}

await router.push('/')
const url = decorateUrl('/')
if (url.startsWith('http')) {
window.location.href = url
} else {
window.location.href = url
}
},
})
} else {
Expand Down
27 changes: 21 additions & 6 deletions docs/guides/development/custom-flows/authentication/legacy/email-password-mfa.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -98,15 +98,20 @@ This guide will walk you through how to build a custom email/password sign-in fl
if (signInAttempt.status === 'complete') {
await setActive({
session: signInAttempt.createdSessionId,
navigate: async ({ session }) => {
navigate: async ({ session, decorateUrl }) => {
if (session?.currentTask) {
// Check for tasks and navigate to custom UI to help users resolve them
// See https://clerk.com/docs/guides/development/custom-flows/authentication/session-tasks
console.log(session?.currentTask)
return
}

await router.push('/')
const url = decorateUrl('/')
if (url.startsWith('http')) {
window.location.href = url
} else {
router.push(url)
}
},
})
} else {
Expand Down Expand Up @@ -386,15 +391,20 @@ This guide will walk you through how to build a custom email/password sign-in fl
if (attemptFirstFactor.status === 'complete') {
await setActive({
session: attemptFirstFactor.createdSessionId,
navigate: async ({ session }) => {
navigate: async ({ session, decorateUrl }) => {
if (session?.currentTask) {
// Check for tasks and navigate to custom UI to help users resolve them
// See https://clerk.com/docs/guides/development/custom-flows/authentication/session-tasks
console.log(session?.currentTask)
return
}

await router.push('/')
const url = decorateUrl('/')
if (url.startsWith('http')) {
window.location.href = url
} else {
router.push(url)
}
},
})
} else if (attemptFirstFactor.status === 'needs_second_factor') {
Expand Down Expand Up @@ -428,15 +438,20 @@ This guide will walk you through how to build a custom email/password sign-in fl
if (attemptSecondFactor.status === 'complete') {
await setActive({
session: attemptSecondFactor.createdSessionId,
navigate: async ({ session }) => {
navigate: async ({ session, decorateUrl }) => {
if (session?.currentTask) {
// Check for tasks and navigate to custom UI to help users resolve them
// See https://clerk.com/docs/guides/development/custom-flows/authentication/session-tasks
console.log(session?.currentTask)
return
}

await router.push('/')
const url = decorateUrl('/')
if (url.startsWith('http')) {
window.location.href = url
} else {
router.push(url)
}
},
})
} else {
Expand Down
Loading