UNPKG

next

Version:

The React Framework

73 lines (48 loc) 3.44 kB
--- title: devIndicators description: Configuration options for the on-screen indicator that gives context about the current route you're viewing during development. --- `devIndicators` allows you to configure the on-screen indicator that gives context about the current route you're viewing during development. Open `next.config.ts` and set `position` to choose where the indicator renders. The default is `bottom-left`. ```ts filename="next.config.ts" import type { NextConfig } from 'next' const nextConfig: NextConfig = { devIndicators: { position: 'bottom-right', // 'bottom-left' | 'bottom-right' | 'top-left' | 'top-right' }, } export default nextConfig ``` To hide the indicator entirely, set `devIndicators` to `false`. Next.js will still surface any compile or runtime errors that were encountered. ```ts filename="next.config.ts" const nextConfig: NextConfig = { devIndicators: false, } export default nextConfig ``` ## Troubleshooting ### Indicator not marking a route as static If you expect a route to be static and the indicator has marked it as dynamic, it's likely the route has opted out of prerendering. You can confirm if a route is [prerendered](/docs/app/glossary#prerendering) or [dynamically rendered](/docs/app/glossary#dynamic-rendering) by building your application using `next build --debug`, and checking the output in your terminal. Static (or prerendered) routes will display a `` symbol, whereas dynamic routes will display a `ƒ` symbol. For example: ```bash filename="Build Output" Route (app) /_not-found ƒ /products/[id] (Static) prerendered as static content ƒ (Dynamic) server-rendered on demand ``` <AppOnly> There are two reasons a route might opt out of prerendering: - The presence of [Request-time APIs](/docs/app/glossary#request-time-apis) which rely on request information. - An [uncached data request](/docs/app/getting-started/fetching-data), like a call to an ORM or database driver. Check your route for any of these conditions, and if you are not able to statically render the route, then consider using [`loading.js`](/docs/app/api-reference/file-conventions/loading) or [`<Suspense />`](https://react.dev/reference/react/Suspense) to leverage [streaming](/docs/app/getting-started/linking-and-navigating#streaming). </AppOnly> <PagesOnly> When exporting [`getServerSideProps`](/docs/pages/building-your-application/data-fetching/get-server-side-props) or [`getInitialProps`](/docs/pages/api-reference/functions/get-initial-props) from a page, it will be marked as dynamic. </PagesOnly> ## Version History | Version | Changes | | --------- | --------------------------------------------------------------------------------------------------------------------------------------------------- | | `v16.0.0` | `appIsrStatus`, `buildActivity`, and `buildActivityPosition` options have been removed. | | `v15.2.0` | Improved on-screen indicator with new `position` option. `appIsrStatus`, `buildActivity`, and `buildActivityPosition` options have been deprecated. | | `v15.0.0` | Static on-screen indicator added with `appIsrStatus` option. |