1import versions from '~/public/static/constants/versions.json'; 2 3export function getRedirectPath(redirectPath: string): string { 4 // index.html is no longer a thing in our docs 5 if (pathIncludesIndexHtml(redirectPath)) { 6 redirectPath = redirectPath.replace('index.html', ''); 7 } 8 9 // Remove the .html extension if it is included in the path 10 if (pathIncludesHtmlExtension(redirectPath)) { 11 redirectPath = redirectPath.replace('.html', ''); 12 } 13 14 // Unsure why this is happening, but sometimes URLs end up with /null in 15 // the last path part 16 // https://docs.expo.dev/versions/latest/sdk/overview/null 17 if (endsInNull(redirectPath)) { 18 redirectPath = redirectPath.replace(/null$/, ''); 19 } 20 21 // Add a trailing slash if there is not one 22 if (redirectPath[redirectPath.length - 1] !== '/') { 23 redirectPath = `${redirectPath}/`; 24 } 25 26 // A list of pages we know are renamed and can redirect 27 if (RENAMED_PAGES[redirectPath]) { 28 redirectPath = RENAMED_PAGES[redirectPath]; 29 } 30 31 // Catch any unversioned paths which are also renamed 32 if (isVersionedPath(redirectPath)) { 33 const unversionedPath = removeVersionFromPath(redirectPath); 34 if (RENAMED_PAGES[unversionedPath]) { 35 redirectPath = RENAMED_PAGES[unversionedPath]; 36 } 37 } 38 39 // Check if the version is documented, replace it with latest if not 40 if (!isVersionDocumented(redirectPath)) { 41 redirectPath = replaceVersionWithLatest(redirectPath); 42 } 43 44 // Remove versioning from path if this section is no longer versioned 45 if (isVersionedPath(redirectPath) && !pathRequiresVersioning(redirectPath)) { 46 redirectPath = removeVersionFromPath(redirectPath); 47 } 48 49 // Catch any redirects to sdk paths without versions and send to the latest version 50 if (redirectPath.startsWith('/sdk/')) { 51 redirectPath = `/versions/latest${redirectPath}`; 52 } 53 54 // If a page is missing for react-native paths we redirect to react-native docs 55 if (redirectPath.match(/\/versions\/.*\/react-native\//)) { 56 const pathParts = redirectPath.split('/'); 57 const page = pathParts[pathParts.length - 2]; 58 redirectPath = `https://reactnative.dev/docs/${page}`; 59 } 60 61 // Remove version from path if the version is still supported, to redirect to the root 62 if (isVersionedPath(redirectPath) && isVersionDocumented(redirectPath)) { 63 redirectPath = `/versions/${getVersionFromPath(redirectPath)}/`; 64 } 65 66 return redirectPath; 67} 68 69function getVersionFromPath(path: string) { 70 const pathParts = path.split(/\//); 71 // eg: ["", "versions", "v32.0.0", ""] 72 return pathParts[2]; 73} 74 75// Filter unversioned and latest out, so we end up with v34, etc. 76const supportedVersions = versions.VERSIONS.filter(v => v.match(/^v/)); 77 78// Return true if the version is still included in documentation 79function isVersionDocumented(path: string) { 80 return supportedVersions.includes(getVersionFromPath(path)); 81} 82 83function pathIncludesHtmlExtension(path: string) { 84 return !!path.match(/\.html$/); 85} 86 87function pathIncludesIndexHtml(path: string) { 88 return !!path.match(/index\.html$/); 89} 90 91const VERSION_PART_PATTERN = `(latest|unversioned|v\\d+\\.\\d+.\\d+)`; 92const VERSIONED_PATH_PATTERN = `^\\/versions\\/${VERSION_PART_PATTERN}`; 93const SDK_PATH_PATTERN = `${VERSIONED_PATH_PATTERN}/sdk`; 94const REACT_NATIVE_PATH_PATTERN = `${VERSIONED_PATH_PATTERN}/react-native`; 95 96// Check if path is valid (matches /versions/some-valid-version-here/) 97function isVersionedPath(path: string) { 98 return !!path.match(new RegExp(VERSIONED_PATH_PATTERN)); 99} 100 101// Replace an unsupported SDK version with latest 102function replaceVersionWithLatest(path: string) { 103 return path.replace(new RegExp(VERSION_PART_PATTERN), 'latest'); 104} 105 106/** 107 * Determine if the path requires versioning, if not we can remove the versioned prefix from the path. 108 * The following paths require versioning: 109 * - `/versions/<version>/sdk/**`, pages within the Expo SDK docs. 110 * - `/versions/<version>/react-native/**`, pages within the React Native API docs. 111 * - `/versions/<version>/`, the index of a specific Expo SDK version. 112 * All other paths shouldn't require versioning, some of them are: 113 * - `/versions/<version>/workflow/expo-cli/, moved outside versioned folders. 114 * - `/versions/<version>/guides/assets/, moved outside versioned folders. 115 */ 116function pathRequiresVersioning(path: string) { 117 const isExpoSdkPage = path.match(new RegExp(SDK_PATH_PATTERN)); 118 const isExpoSdkIndexPage = path.match(new RegExp(VERSIONED_PATH_PATTERN + '/$')); 119 const isReactNativeApiPage = path.match(new RegExp(REACT_NATIVE_PATH_PATTERN)); 120 121 return isExpoSdkIndexPage || isExpoSdkPage || isReactNativeApiPage; 122} 123 124function removeVersionFromPath(path: string) { 125 return path.replace(new RegExp(VERSIONED_PATH_PATTERN), ''); 126} 127 128// Not sure why this happens but sometimes the URL ends in /null 129function endsInNull(path: string) { 130 return !!path.match(/\/null$/); 131} 132 133// Simple remapping of renamed pages, similar to in deploy.sh but in some cases, 134// for reasons I'm not totally clear on, those redirects do not work 135const RENAMED_PAGES: Record<string, string> = { 136 '/introduction/project-lifecycle/': '/introduction/managed-vs-bare/', 137 '/guides/': '/workflow/exploring-managed-workflow/', 138 '/versions/latest/sdk/': '/versions/latest/', 139 '/versions/latest/sdk/overview/': '/versions/latest/', 140 '/guides/building-standalone-apps/': '/archive/classic-updates/building-standalone-apps/', 141 '/distribution/building-standalone-apps/': '/archive/classic-updates/building-standalone-apps/', 142 '/guides/genymotion/': '/workflow/android-studio-emulator/', 143 '/workflow/upgrading-expo/': '/workflow/upgrading-expo-sdk-walkthrough/', 144 '/workflow/create-react-native-app/': '/workflow/glossary-of-terms/#create-react-native-app', 145 '/expokit/': '/archive/glossary/#expokit/', 146 147 // Development builds redirects 148 '/development/build/': '/development/create-development-builds/', 149 '/development/getting-started/': '/development/create-development-builds/', 150 '/development/troubleshooting/': '/development/introduction/', 151 '/development/upgrading/': '/development/introduction/', 152 '/development/extensions/': '/development/development-workflows/', 153 '/development/develop-your-project': '/development/use-development-builds', 154 155 // Consolidate workflow page 156 '/bare/customizing/': '/workflow/customizing/', 157 158 // Lots of old links pointing to guides when they have moved elsewhere 159 '/guides/configuration/': '/workflow/configuration/', 160 '/guides/expokit/': '/archive/glossary/#expokit/', 161 '/guides/publishing/': '/archive/classic-updates/publishing/', 162 '/workflow/publishing/': '/archive/classic-updates/publishing/', 163 '/guides/linking/': '/workflow/linking/', 164 '/guides/up-and-running/': '/get-started/installation/', 165 '/guides/debugging/': '/workflow/debugging/', 166 '/guides/logging/': '/workflow/logging/', 167 '/introduction/troubleshooting-proxies/': '/guides/troubleshooting-proxies/', 168 '/introduction/running-in-the-browser/': '/guides/running-in-the-browser/', 169 '/guides/using-electron/': 170 'https://dev.to/evanbacon/making-desktop-apps-with-electron-react-native-and-expo-5e36', 171 172 // Changes from redoing the getting started workflow, SDK35+ 173 '/workflow/up-and-running/': '/get-started/installation/', 174 '/introduction/additional-resources/': '/next-steps/additional-resources/', 175 '/introduction/already-used-react-native/': '/workflow/already-used-react-native/', 176 '/introduction/community/': '/next-steps/community/', 177 '/introduction/installation/': '/get-started/installation/', 178 '/versions/latest/overview/': '/versions/latest/', 179 '/versions/latest/introduction/installation/': '/get-started/installation/', 180 '/workflow/exploring-managed-workflow/': '/tutorial/introduction/', 181 '/introduction/walkthrough/': '/tutorial/introduction/', 182 183 // Move overview to index 184 '/versions/v37.0.0/sdk/overview/': '/versions/v37.0.0/', 185 186 // Errors and debugging is better suited for getting started than tutorial 187 '/tutorial/errors/': '/get-started/errors/', 188 189 // Redirects based on Next 9 upgrade (09/11/2020) 190 '/api/': '/versions/latest/', 191 192 // Redirect to expand Expo Accounts and permissions 193 '/guides/account-permissions/': '/accounts/personal/', 194 195 // Redirects based on Sentry reports 196 '/next-steps/installation/': '/get-started/installation/', 197 '/guides/release-channels/': '/archive/classic-updates/release-channels/', 198 '/guides/push-notifications/': '/push-notifications/overview/', 199 '/guides/using-fcm/': '/push-notifications/using-fcm/', 200 '/push-notifications/': '/push-notifications/overview/', 201 '/distribution/hosting-your-app/': '/distribution/publishing-websites/', 202 '/build-reference/how-tos/': '/build-reference/private-npm-packages/', 203 '/get-started/': '/get-started/installation/', 204 '/guides/detach/': '/archive/glossary/#detach', 205 206 // Renaming a submit section 207 '/submit/submit-ios': '/submit/ios/', 208 '/submit/submit-android': '/submit/android/', 209 210 // Fundamentals had too many things 211 '/workflow/linking/': '/guides/linking/', 212 '/workflow/how-expo-works/': '/workflow/already-used-react-native/#how-does-expo-work', 213 '/guides/how-expo-works/': '/workflow/already-used-react-native/#how-does-expo-work', 214 215 // Archive unused pages 216 '/guides/notification-channels/': '/archived/notification-channels/', 217 218 // Migrated FAQ pages 219 '/faq/image-background/': '/ui-programming/image-background/', 220 '/faq/react-native-styling-buttons/': '/ui-programming/react-native-styling-buttons/', 221 '/faq/react-native-version-mismatch/': '/troubleshooting/react-native-version-mismatch/', 222 '/faq/clear-cache-windows/': '/troubleshooting/clear-cache-windows/', 223 '/faq/clear-cache-macos-linux/': '/troubleshooting/clear-cache-macos-linux/', 224 '/faq/application-has-not-been-registered/': 225 '/troubleshooting/application-has-not-been-registered/', 226 227 // Permissions API is moved to guide 228 '/versions/v40.0.0/sdk/permissions/': '/guides/permissions/', 229 '/versions/v41.0.0/sdk/permissions/': '/guides/permissions/', 230 '/versions/v42.0.0/sdk/permissions/': '/guides/permissions/', 231 '/versions/v43.0.0/sdk/permissions/': '/guides/permissions/', 232 '/versions/latest/sdk/permissions/': '/guides/permissions/', 233 234 // Redirect Gatsby guide to index guides page 235 '/guides/using-gatsby/': '/guides/', 236 237 // Classic updates moved to archive 238 '/guides/configuring-ota-updates/': '/archive/classic-updates/getting-started/', 239 '/guides/configuring-updates/': '/archive/classic-updates/getting-started/', 240 '/distribution/release-channels/': '/archive/classic-updates/release-channels/', 241 '/distribution/advanced-release-channels/': '/archive/classic-updates/advanced-release-channels/', 242 '/distribution/optimizing-updates/': '/archive/classic-updates/optimizing-updates/', 243 '/eas-update/custom-updates-server/': '/distribution/custom-updates-server/', 244 '/guides/offline-support/': '/archive/classic-updates/offline-support/', 245 '/guides/preloading-and-caching-assets/': 246 '/archive/classic-updates/preloading-and-caching-assets/', 247 '/eas-update/bare-react-native/': '/bare/updating-your-app/', 248 '/worfkflow/publishing/': '/archive/classic-updates/publishing/', 249 '/classic/building-standalone-apps/': '/archive/classic-updates/building-standalone-apps/', 250 '/classic/turtle-cli/': '/archive/classic-updates/turtle-cli/', 251 '/archive/classic-updates/getting-started/': '/eas-update/getting-started/', 252 253 // Redirect bare guides to unified workflow guides 254 '/bare/using-libraries/': '/workflow/using-libraries/', 255 '/bare/exploring-bare-workflow/': '/bare/hello-world/', 256 '/bare/existing-apps/': '/bare/installing-expo-modules/', 257 '/bare/installing-unimodules/': '/bare/installing-expo-modules/', 258 '/bare/using-web/': '/workflow/web/', 259 '/guides/running-in-the-browser/': '/workflow/web/', 260 '/bare/unimodules-full-list/': '/bare/hello-world/', 261 262 // Consolidate distribution 263 '/distribution/security/': '/app-signing/security/', 264 '/distribution/uploading-apps/': '/submit/introduction/', 265 '/versions/latest/distribution/uploading-apps/': '/submit/introduction/', 266 267 // Deleted or removed guides 268 '/guides/setup-native-firebase/': '/guides/using-firebase/', 269 '/guides/using-clojurescript/': '/', 270 271 // Redirects from old to new tutorial 272 '/tutorial/planning/': '/tutorial/introduction/', 273 '/tutorial/sharing/': '/tutorial/introduction/', 274 '/tutorial/text/': '/tutorial/introduction/', 275 276 // Redirects for removed /archived pages 277 '/archived/': '/archive/', 278 '/versions/latest/expokit/eject/': '/archive/glossary/#eject', 279 '/expokit/eject/': '/archive/glossary/#eject', 280 '/expokit/expokit/': '/archive/glossary/#expokit', 281 '/submit/classic-builds/': '/submit/introduction/', 282 283 // Redirects for removed API docs based on Sentry 284 '/versions/latest/sdk/facebook/': '/guides/authentication/', 285 '/versions/latest/sdk/taskmanager/': '/versions/latest/sdk/task-manager/', 286 '/versions/latest/sdk/videothumbnails/': '/versions/latest/sdk/video-thumbnails/', 287 '/versions/latest/sdk/appearance/': '/versions/latest/react-native/appearance/', 288 '/versions/latest/sdk/app-loading/': '/versions/latest/sdk/splash-screen/', 289 '/versions/latest/sdk/app-auth/': '/guides/authentication/', 290 '/versions/latest/sdk/google-sign-in/': '/guides/authentication/', 291 '/versions/latest/sdk/branch/': 292 'https://github.com/expo/config-plugins/tree/main/packages/react-native-branch', 293 '/versions/latest/sdk/appstate/': '/versions/latest/react-native/appstate/', 294 '/versions/latest/sdk/google/': '/guides/authentication/', 295 '/versions/latest/sdk/firebase-core/': '/guides/using-firebase/', 296 '/versions/latest/sdk/firebase-analytics/': '/guides/using-firebase/', 297 '/versions/latest/sdk/firebase-recaptcha/': '/guides/using-firebase/', 298 '/versions/latest/sdk/amplitude/': '/guides/using-analytics/', 299 '/versions/latest/sdk/util/': '/versions/latest/', 300 // Push notifications 301 '/push-notifications/using-fcm/': '/push-notifications/push-notifications-setup', 302 '/config/app/': '/workflow/configuration/', 303}; 304