SuperAPI AI Directory

nextjs-app

Frontend & websites

View repository

Updated 10-16 08:37

About this skill

Scope

This skill is dedicated to Next.js's App Router(app/ directory)This is the reference for. Pages Router (pages/ directory,getStaticProps / getServerSideProps / getInitialProps etc.) are out of scope. Only the migration procedure from Pages Router is included in references/guides/app-router-migration.md .

Platform runtime behavior (Vercel's CDN, ISR infrastructure, Edge runtime, deployment configuration) is handled by the vercel skill. This skill focuses exclusively on "how to write with the App Router (API specifications, file conventions)".

Directory Structure

skills/nextjs-app/
  SKILL.md
  references/
    getting-started/
      README.md
      installation.md
      project-structure.md
      layouts-and-pages.md
      linking-and-navigating.md
      server-and-client-components.md
      fetching-data.md
      mutating-data.md
      caching.md
      revalidating.md
      error-handling.md
      css.md
      images.md
      fonts.md
      metadata-and-og-images.md
      route-handlers.md
      proxy.md
      deploying.md
      upgrading.md
    guides/
      README.md
      analytics.md
      app-router-migration.md
      authentication.md
      backend-for-frontend.md
      caching-without-cache-components.md
      ci-build-caching.md
      codemods.md
      content-security-policy.md
      css-in-js.md
      custom-server.md
      cypress.md
      debugging.md
      draft-mode.md
      environment-variables.md
      forms.md
      from-create-react-app.md
      from-vite.md
      incremental-static-regeneration.md
      instrumentation.md
      internationalization.md
      jest.md
      json-ld.md
      lazy-loading.md
      local-development.md
      mdx.md
      memory-usage.md
      multi-tenant.md
      multi-zones.md
      open-telemetry.md
      package-bundling.md
      playwright.md
      ppr-platform-guide.md
      prefetching.md
      production-checklist.md
      progressive-web-apps.md
      redirecting.md
      sass.md
      scripts.md
      self-hosting.md
      server-actions.md
      single-page-applications.md
      static-exports.md
      streaming.md
      tailwind-v3-css.md
      testing.md
      third-party-libraries.md
      version-14.md
      version-15.md
      version-16.md
      videos.md
      vitest.md
    api-reference/
      functions/
        README.md
        after.md
        cacheLife.md
        cacheTag.md
        unstable_catchError.md
        connection.md
        cookies.md
        draftMode.md
        fetch.md
        forbidden.md
        generateImageMetadata.md
        generateMetadata.md
        generateSitemaps.md
        generateStaticParams.md
        generateViewport.md
        headers.md
        ImageResponse.md
        NextRequest.md
        NextResponse.md
        not-found.md
        permanentRedirect.md
        redirect.md
        refresh.md
        revalidatePath.md
        revalidateTag.md
        unauthorized.md
        unstable_cache.md
        unstable_noStore.md
        unstable_rethrow.md
        updateTag.md
        useLinkStatus.md
        use-params.md
        usePathname.md
        useReportWebVitals.md
        useRouter.md
        use-search-params.md
        use-selected-layout-segment.md
        use-selected-layout-segments.md
        userAgent.md
      file-conventions/
        README.md
        default.md
        dynamic-routes.md
        error.md
        forbidden.md
        instrumentation.md
        instrumentation-client.md
        intercepting-routes.md
        layout.md
        loading.md
        mdx-components.md
        not-found.md
        page.md
        parallel-routes.md
        proxy.md
        public-folder.md
        route.md
        route-groups.md
        src-folder.md
        template.md
        unauthorized.md
        metadata.md
        metadata/
          README.md
          app-icons.md
          manifest.md
          opengraph-image.md
          robots.md
          sitemap.md
        route-segment-config.md
        route-segment-config/
          README.md
          dynamicParams.md
          maxDuration.md
          preferredRegion.md
          runtime.md
      components/
        README.md
        font.md
        form.md
        image.md
        link.md
        script.md
      directives/
        README.md
        use-cache.md
        use-cache-private.md
        use-cache-remote.md
        use-client.md
        use-server.md
      config/
        README.md
        overview.md
        images.md
        headers-redirects-rewrites.md
        routing.md
        build-output.md
        caching.md
        bundling.md
        react-experimental.md
        dev-environment.md
        deployment.md
        env-and-checks.md
        typescript.md
        eslint.md
        create-next-app.md
        next-cli.md
      misc/
        README.md
        adapters.md
        adapters-configuration.md
        adapters-creating-an-adapter.md
        adapters-api-reference.md
        adapters-testing-adapters.md
        adapters-routing-with-next-routing.md
        adapters-implementing-ppr-in-an-adapter.md
        adapters-runtime-integration.md
        adapters-invoking-entrypoints.md
        adapters-output-types.md
        adapters-routing-information.md
        adapters-use-cases.md
        edge-runtime.md
        turbopack.md
  samples/
    README.md
    server-component-data-fetching.md
    server-actions-form.md
    dynamic-route-static-params.md
    route-file-conventions.md
    route-handler-get-post.md
    metadata-and-og-image.md
    on-demand-revalidation.md
    streaming-with-suspense.md
    parallel-intercepting-routes-modal.md
  scripts/
    README.md
    install.md
    cli.md
    codemod.md
    telemetry.md
    info.md
    bundle-analyzer.md
    env.md

Exploration Procedure

Look up the category from the task, and identify the target page in the category's README.md:

  1. First, check whether the target is a topic of App Router (Pages Router APIs are out of scope for this skill)
  2. Find the category corresponding to the task in the mapping table below
  3. The README.md for that category (references/{category}/README.md or samples/README.md / scripts/README.md) to identify the target page
  4. Read the corresponding page's .md to check the details
  5. Deployment destination CDN behavior, ISR infrastructure, Edge runtime, etc.Platform-side topicsは vercel refer to the skill

Task → Category mapping

Basic Concepts & Setup

Task Category Reference README
Want to create a new project, want to know the folder structure getting-started references/getting-started/README.md
Want to know how to create pages/layouts and how to use Server/Client Components properly getting-started references/getting-started/README.md
Want to know the basics of data fetching and data mutation (Server Actions) getting-started references/getting-started/README.md
Want to know the basics of CSS, image, font optimization, and metadata getting-started references/getting-started/README.md

Feature Guides & Operations

Task Category Reference README
Want to implement forms with Server Actions, want to implement authentication and internationalization guides references/guides/README.md
Want to use ISR, Draft Mode, streaming, and PPR guides references/guides/README.md
I want to test with Jest/Vitest/Playwright/Cypress guides references/guides/README.md
Want to know how to migrate from Pages Router / CRA / Vite and the upgrade procedure guides references/guides/README.md
Want to check multi-tenant and multi-zone configurations and the pre-production checklist guides references/guides/README.md

Function APIs

Task Category Reference README
cookies / headers / redirect / notFound want to know how to use api-reference/functions references/api-reference/functions/README.md
revalidatePath / revalidateTag / unstable_cache want to control caching with api-reference/functions references/api-reference/functions/README.md
generateMetadata / generateStaticParams / generateViewport want to write api-reference/functions references/api-reference/functions/README.md
useRouter / usePathname / useSearchParams / useParams want to use api-reference/functions references/api-reference/functions/README.md

File Conventions

Task Category Reference README
layout / page / loading / error / template / default want to know the role of api-reference/file-conventions references/api-reference/file-conventions/README.md
Want to implement Dynamic Routes / Route Groups / Parallel Routes / Intercepting Routes api-reference/file-conventions references/api-reference/file-conventions/README.md
route.ts want to create a custom API endpoint with api-reference/file-conventions references/api-reference/file-conventions/README.md
Want to know the file conventions for favicon/manifest/robots/sitemap/OG images api-reference/file-conventions references/api-reference/file-conventions/metadata/README.md
dynamicParams / runtime / preferredRegion / maxDuration want to configure api-reference/file-conventions references/api-reference/file-conventions/route-segment-config/README.md

Built-in Components & Directives

Task Category Reference README
next/image / next/font / next/link / Form / next/script want to use api-reference/components references/api-reference/components/README.md
use client / use server / use cache want to know how to use them properly api-reference/directives references/api-reference/directives/README.md

Configuration & Tools

Task Category Reference README
next.config.js Want to investigate the options (images, headers/redirects/rewrites, routing, caching, etc.) api-reference/config references/api-reference/config/README.md
TypeScript / ESLint configuration,create-next-app / next want to use the CLI api-reference/config references/api-reference/config/README.md
Want to create and configure deploy adapters (adapters) api-reference/misc references/api-reference/misc/README.md
Want to know Edge Runtime constraints and Turbopack configuration api-reference/misc references/api-reference/misc/README.md

Examples and commands

Task Category Reference README
Want to know typical usage (data fetching, Server Actions forms, Route Handler, metadata, modals, etc.) samples samples/README.md
Want to know installation, CLI, codemod, telemetry, and bundle analysis commands scripts scripts/README.md

Notes

Task References
Want to know about Vercel's CDN, ISR infrastructure, Edge runtime environment, and deployment configuration vercel skills