skillfullstack 0.0.0-stage → 1.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.skillsRegistry/catalog.json +231 -0
- package/AGENTS.md +89 -0
- package/README.md +210 -2
- package/bin/index.js +508 -0
- package/package.json +57 -4
- package/skills/backend/apiEngineering/SKILL.md +102 -0
- package/skills/backend/apiEngineering/evals/evalApiEngineering.py +81 -0
- package/skills/backend/apiEngineering/evals/fixtures/invalid/sampleInvalidOpenApi.json +40 -0
- package/skills/backend/apiEngineering/evals/fixtures/valid/sampleValidOpenApi.json +47 -0
- package/skills/backend/apiEngineering/policies/compatibility.md +42 -0
- package/skills/backend/apiEngineering/policies/mandatory.md +48 -0
- package/skills/backend/apiEngineering/policies/performance.md +39 -0
- package/skills/backend/apiEngineering/policies/security.md +36 -0
- package/skills/backend/apiEngineering/references/apiObservability.md +39 -0
- package/skills/backend/apiEngineering/references/apiReference.md +3 -0
- package/skills/backend/apiEngineering/references/apiSecurityOwasp.md +47 -0
- package/skills/backend/apiEngineering/references/contractCompatibility.md +26 -0
- package/skills/backend/apiEngineering/references/databaseTransactions.md +40 -0
- package/skills/backend/apiEngineering/references/distributedReliability.md +26 -0
- package/skills/backend/apiEngineering/references/multiTenancy.md +27 -0
- package/skills/backend/apiEngineering/references/openApi32Standards.md +58 -0
- package/skills/backend/apiEngineering/references/paginationVersioning.md +57 -0
- package/skills/backend/apiEngineering/references/responseStandards.md +94 -0
- package/skills/backend/apiEngineering/scripts/auditApiContract.py +123 -0
- package/skills/backend/apiEngineering/scripts/checkBreakingChanges.py +77 -0
- package/skills/backend/apiEngineering/scripts/generateResponseEnvelope.py +88 -0
- package/skills/backend/apiEngineering/templates/apiChecklist.md +27 -0
- package/skills/backend/apiEngineering/templates/openapi.yaml +125 -0
- package/skills/backend/apiEngineering/templates/problemDetails.json +44 -0
- package/skills/backend/databaseArchitecture/SKILL.md +118 -0
- package/skills/backend/databaseArchitecture/evals/evalDatabaseArchitecture.py +85 -0
- package/skills/backend/databaseArchitecture/evals/fixtures/dangerousMigration.sql +4 -0
- package/skills/backend/databaseArchitecture/evals/fixtures/invalidSchema.sql +23 -0
- package/skills/backend/databaseArchitecture/evals/fixtures/safeMigration.sql +3 -0
- package/skills/backend/databaseArchitecture/evals/fixtures/validSchema.sql +37 -0
- package/skills/backend/databaseArchitecture/policies/integrity.md +25 -0
- package/skills/backend/databaseArchitecture/policies/mandatory.md +32 -0
- package/skills/backend/databaseArchitecture/policies/migration.md +22 -0
- package/skills/backend/databaseArchitecture/policies/normalization.md +25 -0
- package/skills/backend/databaseArchitecture/policies/performance.md +26 -0
- package/skills/backend/databaseArchitecture/policies/recovery.md +23 -0
- package/skills/backend/databaseArchitecture/policies/security.md +26 -0
- package/skills/backend/databaseArchitecture/policies/tableCreationChecklist.md +70 -0
- package/skills/backend/databaseArchitecture/references/analyticsWarehousing.md +32 -0
- package/skills/backend/databaseArchitecture/references/apiReference.md +3 -0
- package/skills/backend/databaseArchitecture/references/backupDisasterRecovery.md +27 -0
- package/skills/backend/databaseArchitecture/references/dataModelingLifecycle.md +30 -0
- package/skills/backend/databaseArchitecture/references/databaseTaxonomy.md +32 -0
- package/skills/backend/databaseArchitecture/references/indexingOptimization.md +32 -0
- package/skills/backend/databaseArchitecture/references/normalizationTheory.md +61 -0
- package/skills/backend/databaseArchitecture/references/scalabilitySharding.md +37 -0
- package/skills/backend/databaseArchitecture/references/transactionConcurrency.md +39 -0
- package/skills/backend/databaseArchitecture/scripts/analyzeMigration.py +99 -0
- package/skills/backend/databaseArchitecture/scripts/auditDatabaseSchema.py +177 -0
- package/skills/backend/databaseArchitecture/scripts/inspectDatabaseIndexes.py +149 -0
- package/skills/backend/databaseArchitecture/templates/adrTemplate.md +32 -0
- package/skills/backend/databaseArchitecture/templates/databaseChecklist.md +29 -0
- package/skills/backend/databaseArchitecture/templates/migrationPlan.md +40 -0
- package/skills/backend/durableBackgroundJobs/SKILL.md +112 -0
- package/skills/backend/durableBackgroundJobs/evals/durableJobVerification.json +14 -0
- package/skills/backend/durableBackgroundJobs/references/apiReference.md +3 -0
- package/skills/backend/durableBackgroundJobs/references/durableStepPatterns.md +6 -0
- package/skills/backend/durableBackgroundJobs/references/idempotencyKeys.md +5 -0
- package/skills/backend/durableBackgroundJobs/scripts/testWorkflowDispatch.py +24 -0
- package/skills/backend/golangStandard/SKILL.md +155 -0
- package/skills/backend/golangStandard/evals/goVerification.json +14 -0
- package/skills/backend/golangStandard/references/apiReference.md +3 -0
- package/skills/backend/golangStandard/references/layoutGuide.md +26 -0
- package/skills/backend/golangStandard/references/slogPatterns.md +26 -0
- package/skills/backend/golangStandard/scripts/scaffoldGoModule.py +105 -0
- package/skills/backend/pythonStandard/SKILL.md +138 -0
- package/skills/backend/pythonStandard/evals/pythonVerification.json +14 -0
- package/skills/backend/pythonStandard/references/apiReference.md +3 -0
- package/skills/backend/pythonStandard/references/pydanticPatterns.md +16 -0
- package/skills/backend/pythonStandard/references/pyprojectSpecs.md +37 -0
- package/skills/backend/pythonStandard/scripts/scaffoldUvProject.py +79 -0
- package/skills/backend/upstash/SKILL.md +98 -0
- package/skills/backend/upstash/evals/upstashVerification.json +14 -0
- package/skills/backend/upstash/references/apiReference.md +3 -0
- package/skills/backend/upstash/references/qstashFlowControl.md +34 -0
- package/skills/backend/upstash/references/ratelimitPatterns.md +53 -0
- package/skills/backend/upstash/references/workflowPatterns.md +35 -0
- package/skills/backend/upstash/scripts/testRedisConnection.py +36 -0
- package/skills/cicdDevops/cicdPipeline/SKILL.md +148 -0
- package/skills/cicdDevops/cicdPipeline/evals/evalCicd.py +37 -0
- package/skills/cicdDevops/cicdPipeline/references/apiReference.md +3 -0
- package/skills/cicdDevops/cicdPipeline/references/cicdDeploymentPatterns.md +27 -0
- package/skills/cicdDevops/cicdPipeline/scripts/auditDockerfileSecurity.py +56 -0
- package/skills/dataAi/mcpServerDevelopment/SKILL.md +123 -0
- package/skills/dataAi/mcpServerDevelopment/evals/mcpVerification.json +14 -0
- package/skills/dataAi/mcpServerDevelopment/references/apiReference.md +3 -0
- package/skills/dataAi/mcpServerDevelopment/references/mcpClientConfigs.md +38 -0
- package/skills/dataAi/mcpServerDevelopment/references/toolSchemaDesign.md +6 -0
- package/skills/dataAi/mcpServerDevelopment/scripts/runFastMcpBoilerplate.py +36 -0
- package/skills/dataAi/ragPipelineProduction/SKILL.md +113 -0
- package/skills/dataAi/ragPipelineProduction/evals/ragVerification.json +14 -0
- package/skills/dataAi/ragPipelineProduction/references/apiReference.md +3 -0
- package/skills/dataAi/ragPipelineProduction/references/chunkingStrategies.md +10 -0
- package/skills/dataAi/ragPipelineProduction/references/rrfAlgorithm.md +13 -0
- package/skills/dataAi/ragPipelineProduction/scripts/runHybridRrfSearch.py +33 -0
- package/skills/devopsCloud/cloudflare/SKILL.md +282 -0
- package/skills/devopsCloud/cloudflare/assets/README.md +48 -0
- package/skills/devopsCloud/cloudflare/assets/ai/agents-sdk.md +118 -0
- package/skills/devopsCloud/cloudflare/assets/ai/ai-gateway.md +105 -0
- package/skills/devopsCloud/cloudflare/assets/ai/ai-search.md +129 -0
- package/skills/devopsCloud/cloudflare/assets/ai/workers-ai.md +127 -0
- package/skills/devopsCloud/cloudflare/assets/cli/c3.md +292 -0
- package/skills/devopsCloud/cloudflare/assets/cli/cf-cli.md +90 -0
- package/skills/devopsCloud/cloudflare/assets/cli/wrangler.md +43 -0
- package/skills/devopsCloud/cloudflare/assets/compute/cron-triggers.md +486 -0
- package/skills/devopsCloud/cloudflare/assets/compute/service-bindings.md +251 -0
- package/skills/devopsCloud/cloudflare/assets/compute/smart-placement.md +435 -0
- package/skills/devopsCloud/cloudflare/assets/compute/static-assets.md +220 -0
- package/skills/devopsCloud/cloudflare/assets/compute/workers.md +129 -0
- package/skills/devopsCloud/cloudflare/assets/database-storage/d1.md +105 -0
- package/skills/devopsCloud/cloudflare/assets/database-storage/durable-objects.md +122 -0
- package/skills/devopsCloud/cloudflare/assets/database-storage/hyperdrive.md +210 -0
- package/skills/devopsCloud/cloudflare/assets/database-storage/kv.md +198 -0
- package/skills/devopsCloud/cloudflare/assets/database-storage/queues.md +105 -0
- package/skills/devopsCloud/cloudflare/assets/database-storage/r2.md +105 -0
- package/skills/devopsCloud/cloudflare/assets/database-storage/vectorize.md +97 -0
- package/skills/devopsCloud/cloudflare/assets/database-storage/workflows.md +141 -0
- package/skills/devopsCloud/cloudflare/assets/llms.txt +143 -0
- package/skills/devopsCloud/cloudflare/assets/networking-security/cache-cdn.md +109 -0
- package/skills/devopsCloud/cloudflare/assets/networking-security/dns.md +71 -0
- package/skills/devopsCloud/cloudflare/assets/networking-security/rate-limiting.md +130 -0
- package/skills/devopsCloud/cloudflare/assets/networking-security/tunnels.md +57 -0
- package/skills/devopsCloud/cloudflare/assets/networking-security/waf.md +143 -0
- package/skills/devopsCloud/cloudflare/assets/troubleshooting/1xxx-errors.md +209 -0
- package/skills/devopsCloud/cloudflare/assets/troubleshooting/5xx-errors.md +111 -0
- package/skills/devopsCloud/cloudflare/assets/troubleshooting/http-status-codes.md +38 -0
- package/skills/devopsCloud/cloudflare/evals/evals.json +75 -0
- package/skills/devopsCloud/cloudflare/references/ai-gateway/README.md +27 -0
- package/skills/devopsCloud/cloudflare/references/ai-gateway/configuration.md +18 -0
- package/skills/devopsCloud/cloudflare/references/ai-gateway/dynamic-routing.md +15 -0
- package/skills/devopsCloud/cloudflare/references/ai-gateway/features.md +22 -0
- package/skills/devopsCloud/cloudflare/references/ai-gateway/sdk-integration.md +19 -0
- package/skills/devopsCloud/cloudflare/references/ai-gateway/troubleshooting.md +16 -0
- package/skills/devopsCloud/cloudflare/references/ai-search/README.md +25 -0
- package/skills/devopsCloud/cloudflare/references/ai-search/api.md +13 -0
- package/skills/devopsCloud/cloudflare/references/ai-search/configuration.md +16 -0
- package/skills/devopsCloud/cloudflare/references/ai-search/gotchas.md +13 -0
- package/skills/devopsCloud/cloudflare/references/ai-search/patterns.md +15 -0
- package/skills/devopsCloud/cloudflare/references/bindings/README.md +16 -0
- package/skills/devopsCloud/cloudflare/references/bindings/api.md +19 -0
- package/skills/devopsCloud/cloudflare/references/bindings/configuration.md +20 -0
- package/skills/devopsCloud/cloudflare/references/bindings/gotchas.md +18 -0
- package/skills/devopsCloud/cloudflare/references/bindings/patterns.md +20 -0
- package/skills/devopsCloud/cloudflare/references/browser-rendering/README.md +18 -0
- package/skills/devopsCloud/cloudflare/references/browser-rendering/api.md +12 -0
- package/skills/devopsCloud/cloudflare/references/browser-rendering/configuration.md +12 -0
- package/skills/devopsCloud/cloudflare/references/browser-rendering/gotchas.md +15 -0
- package/skills/devopsCloud/cloudflare/references/browser-rendering/patterns.md +12 -0
- package/skills/devopsCloud/cloudflare/references/cliComparison.md +93 -0
- package/skills/devopsCloud/cloudflare/references/containers/README.md +23 -0
- package/skills/devopsCloud/cloudflare/references/containers/api.md +13 -0
- package/skills/devopsCloud/cloudflare/references/containers/configuration.md +15 -0
- package/skills/devopsCloud/cloudflare/references/containers/gotchas.md +16 -0
- package/skills/devopsCloud/cloudflare/references/containers/patterns.md +18 -0
- package/skills/devopsCloud/cloudflare/references/cron-triggers/README.md +20 -0
- package/skills/devopsCloud/cloudflare/references/cron-triggers/api.md +16 -0
- package/skills/devopsCloud/cloudflare/references/cron-triggers/configuration.md +16 -0
- package/skills/devopsCloud/cloudflare/references/cron-triggers/gotchas.md +17 -0
- package/skills/devopsCloud/cloudflare/references/cron-triggers/patterns.md +18 -0
- package/skills/devopsCloud/cloudflare/references/d1/README.md +15 -0
- package/skills/devopsCloud/cloudflare/references/d1/api.md +18 -0
- package/skills/devopsCloud/cloudflare/references/d1/configuration.md +18 -0
- package/skills/devopsCloud/cloudflare/references/d1/gotchas.md +18 -0
- package/skills/devopsCloud/cloudflare/references/d1/patterns.md +21 -0
- package/skills/devopsCloud/cloudflare/references/frameworkCompatibility.md +110 -0
- package/skills/devopsCloud/cloudflare/references/hyperdrive/README.md +28 -0
- package/skills/devopsCloud/cloudflare/references/hyperdrive/api.md +26 -0
- package/skills/devopsCloud/cloudflare/references/hyperdrive/configuration.md +34 -0
- package/skills/devopsCloud/cloudflare/references/hyperdrive/gotchas.md +20 -0
- package/skills/devopsCloud/cloudflare/references/hyperdrive/patterns.md +15 -0
- package/skills/devopsCloud/cloudflare/references/images/README.md +12 -0
- package/skills/devopsCloud/cloudflare/references/images/api.md +13 -0
- package/skills/devopsCloud/cloudflare/references/images/configuration.md +17 -0
- package/skills/devopsCloud/cloudflare/references/images/gotchas.md +16 -0
- package/skills/devopsCloud/cloudflare/references/images/patterns.md +16 -0
- package/skills/devopsCloud/cloudflare/references/kv/README.md +15 -0
- package/skills/devopsCloud/cloudflare/references/kv/api.md +18 -0
- package/skills/devopsCloud/cloudflare/references/kv/configuration.md +16 -0
- package/skills/devopsCloud/cloudflare/references/kv/gotchas.md +17 -0
- package/skills/devopsCloud/cloudflare/references/kv/patterns.md +21 -0
- package/skills/devopsCloud/cloudflare/references/miniflare/README.md +22 -0
- package/skills/devopsCloud/cloudflare/references/miniflare/api.md +16 -0
- package/skills/devopsCloud/cloudflare/references/miniflare/configuration.md +16 -0
- package/skills/devopsCloud/cloudflare/references/miniflare/gotchas.md +15 -0
- package/skills/devopsCloud/cloudflare/references/miniflare/patterns.md +19 -0
- package/skills/devopsCloud/cloudflare/references/observability/README.md +27 -0
- package/skills/devopsCloud/cloudflare/references/observability/api.md +20 -0
- package/skills/devopsCloud/cloudflare/references/observability/configuration.md +23 -0
- package/skills/devopsCloud/cloudflare/references/observability/gotchas.md +25 -0
- package/skills/devopsCloud/cloudflare/references/observability/patterns.md +14 -0
- package/skills/devopsCloud/cloudflare/references/pages/README.md +20 -0
- package/skills/devopsCloud/cloudflare/references/pages/api.md +13 -0
- package/skills/devopsCloud/cloudflare/references/pages/configuration.md +16 -0
- package/skills/devopsCloud/cloudflare/references/pages/gotchas.md +19 -0
- package/skills/devopsCloud/cloudflare/references/pages/patterns.md +15 -0
- package/skills/devopsCloud/cloudflare/references/pages-functions/README.md +20 -0
- package/skills/devopsCloud/cloudflare/references/pages-functions/api.md +13 -0
- package/skills/devopsCloud/cloudflare/references/pages-functions/configuration.md +14 -0
- package/skills/devopsCloud/cloudflare/references/pages-functions/gotchas.md +17 -0
- package/skills/devopsCloud/cloudflare/references/pages-functions/patterns.md +16 -0
- package/skills/devopsCloud/cloudflare/references/productSelectionMatrix.md +54 -0
- package/skills/devopsCloud/cloudflare/references/queues/README.md +24 -0
- package/skills/devopsCloud/cloudflare/references/queues/api.md +16 -0
- package/skills/devopsCloud/cloudflare/references/queues/configuration.md +20 -0
- package/skills/devopsCloud/cloudflare/references/queues/gotchas.md +18 -0
- package/skills/devopsCloud/cloudflare/references/queues/patterns.md +21 -0
- package/skills/devopsCloud/cloudflare/references/r2/README.md +26 -0
- package/skills/devopsCloud/cloudflare/references/r2/api.md +16 -0
- package/skills/devopsCloud/cloudflare/references/r2/configuration.md +19 -0
- package/skills/devopsCloud/cloudflare/references/r2/gotchas.md +17 -0
- package/skills/devopsCloud/cloudflare/references/r2/patterns.md +18 -0
- package/skills/devopsCloud/cloudflare/references/secrets-store/README.md +22 -0
- package/skills/devopsCloud/cloudflare/references/secrets-store/api.md +21 -0
- package/skills/devopsCloud/cloudflare/references/secrets-store/configuration.md +25 -0
- package/skills/devopsCloud/cloudflare/references/secrets-store/gotchas.md +19 -0
- package/skills/devopsCloud/cloudflare/references/secrets-store/patterns.md +27 -0
- package/skills/devopsCloud/cloudflare/references/skill-feedback.md +41 -0
- package/skills/devopsCloud/cloudflare/references/static-assets/README.md +21 -0
- package/skills/devopsCloud/cloudflare/references/static-assets/api.md +16 -0
- package/skills/devopsCloud/cloudflare/references/static-assets/configuration.md +16 -0
- package/skills/devopsCloud/cloudflare/references/static-assets/gotchas.md +18 -0
- package/skills/devopsCloud/cloudflare/references/static-assets/patterns.md +17 -0
- package/skills/devopsCloud/cloudflare/references/stream/README.md +22 -0
- package/skills/devopsCloud/cloudflare/references/stream/api-live.md +18 -0
- package/skills/devopsCloud/cloudflare/references/stream/api.md +21 -0
- package/skills/devopsCloud/cloudflare/references/stream/configuration.md +18 -0
- package/skills/devopsCloud/cloudflare/references/stream/gotchas.md +18 -0
- package/skills/devopsCloud/cloudflare/references/stream/patterns.md +22 -0
- package/skills/devopsCloud/cloudflare/references/tail-workers/README.md +21 -0
- package/skills/devopsCloud/cloudflare/references/tail-workers/api.md +13 -0
- package/skills/devopsCloud/cloudflare/references/tail-workers/configuration.md +15 -0
- package/skills/devopsCloud/cloudflare/references/tail-workers/gotchas.md +16 -0
- package/skills/devopsCloud/cloudflare/references/tail-workers/patterns.md +15 -0
- package/skills/devopsCloud/cloudflare/references/tunnel/README.md +20 -0
- package/skills/devopsCloud/cloudflare/references/tunnel/api.md +14 -0
- package/skills/devopsCloud/cloudflare/references/tunnel/configuration.md +14 -0
- package/skills/devopsCloud/cloudflare/references/tunnel/gotchas.md +15 -0
- package/skills/devopsCloud/cloudflare/references/tunnel/networking.md +14 -0
- package/skills/devopsCloud/cloudflare/references/tunnel/patterns.md +15 -0
- package/skills/devopsCloud/cloudflare/references/vectorize/README.md +22 -0
- package/skills/devopsCloud/cloudflare/references/vectorize/api.md +18 -0
- package/skills/devopsCloud/cloudflare/references/vectorize/configuration.md +19 -0
- package/skills/devopsCloud/cloudflare/references/vectorize/gotchas.md +15 -0
- package/skills/devopsCloud/cloudflare/references/vectorize/patterns.md +24 -0
- package/skills/devopsCloud/cloudflare/references/waf/README.md +21 -0
- package/skills/devopsCloud/cloudflare/references/waf/api.md +17 -0
- package/skills/devopsCloud/cloudflare/references/waf/configuration.md +18 -0
- package/skills/devopsCloud/cloudflare/references/waf/gotchas.md +19 -0
- package/skills/devopsCloud/cloudflare/references/waf/patterns.md +17 -0
- package/skills/devopsCloud/cloudflare/references/workers-ai/README.md +24 -0
- package/skills/devopsCloud/cloudflare/references/workers-ai/api.md +13 -0
- package/skills/devopsCloud/cloudflare/references/workers-ai/configuration.md +16 -0
- package/skills/devopsCloud/cloudflare/references/workers-ai/gotchas.md +15 -0
- package/skills/devopsCloud/cloudflare/references/workers-ai/patterns.md +14 -0
- package/skills/devopsCloud/cloudflare/references/workflows/README.md +23 -0
- package/skills/devopsCloud/cloudflare/references/workflows/api.md +17 -0
- package/skills/devopsCloud/cloudflare/references/workflows/configuration.md +18 -0
- package/skills/devopsCloud/cloudflare/references/workflows/gotchas.md +19 -0
- package/skills/devopsCloud/cloudflare/references/workflows/patterns.md +30 -0
- package/skills/devopsCloud/cloudflare/scripts/auditCloudflareProduction.py +95 -0
- package/skills/foundation/promptEvalTesting/SKILL.md +114 -0
- package/skills/foundation/promptEvalTesting/evals/promptEvalVerification.json +14 -0
- package/skills/foundation/promptEvalTesting/references/apiReference.md +3 -0
- package/skills/foundation/promptEvalTesting/references/evalMetricsCatalog.md +7 -0
- package/skills/foundation/promptEvalTesting/references/promptfooConfigSpecs.md +16 -0
- package/skills/foundation/promptEvalTesting/scripts/runPromptEvalSuite.py +29 -0
- package/skills/frontend/astro/SKILL.md +327 -0
- package/skills/frontend/astro/assets/README.md +71 -0
- package/skills/frontend/astro/assets/add-content-to-your-site/content-collections.md +1061 -0
- package/skills/frontend/astro/assets/add-content-to-your-site/data-fetching.md +109 -0
- package/skills/frontend/astro/assets/add-content-to-your-site/images.md +719 -0
- package/skills/frontend/astro/assets/add-content-to-your-site/markdown.md +725 -0
- package/skills/frontend/astro/assets/build-your-ui/components.md +402 -0
- package/skills/frontend/astro/assets/build-your-ui/fonts.md +437 -0
- package/skills/frontend/astro/assets/build-your-ui/front-end-frameworks.md +245 -0
- package/skills/frontend/astro/assets/build-your-ui/layouts.md +267 -0
- package/skills/frontend/astro/assets/build-your-ui/scripts-and-event-handling.md +229 -0
- package/skills/frontend/astro/assets/build-your-ui/styles-and-css.md +782 -0
- package/skills/frontend/astro/assets/build-your-ui/syntax-highlighting.md +269 -0
- package/skills/frontend/astro/assets/configuration/build-with-ai.md +389 -0
- package/skills/frontend/astro/assets/configuration/configuration-overview.md +122 -0
- package/skills/frontend/astro/assets/configuration/dev-toolbar.md +86 -0
- package/skills/frontend/astro/assets/configuration/editor-setup.md +166 -0
- package/skills/frontend/astro/assets/configuration/environment-variables.md +352 -0
- package/skills/frontend/astro/assets/configuration/typescript.md +379 -0
- package/skills/frontend/astro/assets/configuration/working-with-integrations.md +606 -0
- package/skills/frontend/astro/assets/reference/adapter-reference.md +1242 -0
- package/skills/frontend/astro/assets/reference/cli-reference.md +575 -0
- package/skills/frontend/astro/assets/reference/configuration-reference.md +3144 -0
- package/skills/frontend/astro/assets/reference/content-loader-reference.md +1682 -0
- package/skills/frontend/astro/assets/reference/directives-reference.md +324 -0
- package/skills/frontend/astro/assets/reference/image-service-reference.md +346 -0
- package/skills/frontend/astro/assets/reference/integrations-reference.md +2813 -0
- package/skills/frontend/astro/assets/reference/modules/astro-actions.md +604 -0
- package/skills/frontend/astro/assets/reference/modules/astro-app.md +460 -0
- package/skills/frontend/astro/assets/reference/modules/astro-assets.md +1657 -0
- package/skills/frontend/astro/assets/reference/modules/astro-config.md +395 -0
- package/skills/frontend/astro/assets/reference/modules/astro-content.md +720 -0
- package/skills/frontend/astro/assets/reference/modules/astro-env.md +46 -0
- package/skills/frontend/astro/assets/reference/modules/astro-fetch.md +346 -0
- package/skills/frontend/astro/assets/reference/modules/astro-hono.md +37 -0
- package/skills/frontend/astro/assets/reference/modules/astro-i18n.md +462 -0
- package/skills/frontend/astro/assets/reference/modules/astro-middleware.md +292 -0
- package/skills/frontend/astro/assets/reference/modules/astro-static-paths.md +74 -0
- package/skills/frontend/astro/assets/reference/modules/astro-transitions.md +595 -0
- package/skills/frontend/astro/assets/reference/modules/astro-zod.md +120 -0
- package/skills/frontend/astro/assets/reference/session-driver-reference.md +205 -0
- package/skills/frontend/astro/assets/routing-and-navigation/endpoints.md +251 -0
- package/skills/frontend/astro/assets/routing-and-navigation/internationalization.md +374 -0
- package/skills/frontend/astro/assets/routing-and-navigation/middleware.md +288 -0
- package/skills/frontend/astro/assets/routing-and-navigation/pages.md +205 -0
- package/skills/frontend/astro/assets/routing-and-navigation/prefetch.md +273 -0
- package/skills/frontend/astro/assets/routing-and-navigation/routing.md +760 -0
- package/skills/frontend/astro/assets/routing-and-navigation/view-transitions.md +792 -0
- package/skills/frontend/astro/assets/server-rendering/actions.md +770 -0
- package/skills/frontend/astro/assets/server-rendering/caching.md +255 -0
- package/skills/frontend/astro/assets/server-rendering/on-demand-rendering.md +289 -0
- package/skills/frontend/astro/assets/server-rendering/server-islands.md +126 -0
- package/skills/frontend/astro/assets/server-rendering/sessions.md +270 -0
- package/skills/frontend/astro/assets/start-a-new-project/develop-and-build.md +147 -0
- package/skills/frontend/astro/assets/start-a-new-project/installation.md +342 -0
- package/skills/frontend/astro/assets/start-a-new-project/project-structure.md +137 -0
- package/skills/frontend/astro/assets/upgrade-and-troubleshooting/testing.md +412 -0
- package/skills/frontend/astro/assets/upgrade-and-troubleshooting/troubleshooting.md +229 -0
- package/skills/frontend/astro/assets/upgrade-and-troubleshooting/upgrade-astro.md +205 -0
- package/skills/frontend/astro/assets/welcome/courses.md +46 -0
- package/skills/frontend/astro/assets/welcome/islands-architecture.md +135 -0
- package/skills/frontend/astro/assets/welcome/why-astro.md +90 -0
- package/skills/frontend/astro/evals/evals.json +66 -0
- package/skills/frontend/astro/references/contentCollections.md +164 -0
- package/skills/frontend/astro/references/islandsArchitecture.md +128 -0
- package/skills/frontend/astro/references/serverIslandsAndActions.md +187 -0
- package/skills/frontend/astro/scripts/auditAstroProduction.py +78 -0
- package/skills/frontend/generativeUi/SKILL.md +128 -0
- package/skills/frontend/generativeUi/evals/generativeUiVerification.json +14 -0
- package/skills/frontend/generativeUi/references/apiReference.md +3 -0
- package/skills/frontend/generativeUi/references/clientToolComponentMapping.md +8 -0
- package/skills/frontend/generativeUi/references/dataStreamProtocol.md +10 -0
- package/skills/frontend/generativeUi/scripts/generateUiComponentStub.py +46 -0
- package/skills/frontend/nextjs/SKILL.md +138 -0
- package/skills/frontend/nextjs/assets/README.md +67 -0
- package/skills/frontend/nextjs/assets/api-reference/cli/create-next-app.md +210 -0
- package/skills/frontend/nextjs/assets/api-reference/cli/next.md +484 -0
- package/skills/frontend/nextjs/assets/api-reference/components/font.md +952 -0
- package/skills/frontend/nextjs/assets/api-reference/components/form.md +387 -0
- package/skills/frontend/nextjs/assets/api-reference/components/image.md +1372 -0
- package/skills/frontend/nextjs/assets/api-reference/components/link.md +954 -0
- package/skills/frontend/nextjs/assets/api-reference/components/script.md +421 -0
- package/skills/frontend/nextjs/assets/api-reference/directives/use-cache-private.md +211 -0
- package/skills/frontend/nextjs/assets/api-reference/directives/use-cache-remote.md +652 -0
- package/skills/frontend/nextjs/assets/api-reference/directives/use-cache.md +848 -0
- package/skills/frontend/nextjs/assets/api-reference/directives/use-client.md +149 -0
- package/skills/frontend/nextjs/assets/api-reference/directives/use-server.md +234 -0
- package/skills/frontend/nextjs/assets/api-reference/edge-runtime.md +188 -0
- package/skills/frontend/nextjs/assets/api-reference/file-conventions/default.md +80 -0
- package/skills/frontend/nextjs/assets/api-reference/file-conventions/dynamic-routes.md +417 -0
- package/skills/frontend/nextjs/assets/api-reference/file-conventions/error.md +361 -0
- package/skills/frontend/nextjs/assets/api-reference/file-conventions/forbidden.md +75 -0
- package/skills/frontend/nextjs/assets/api-reference/file-conventions/instrumentation-client.md +308 -0
- package/skills/frontend/nextjs/assets/api-reference/file-conventions/instrumentation.md +177 -0
- package/skills/frontend/nextjs/assets/api-reference/file-conventions/intercepting-routes.md +78 -0
- package/skills/frontend/nextjs/assets/api-reference/file-conventions/layout.md +803 -0
- package/skills/frontend/nextjs/assets/api-reference/file-conventions/loading.md +209 -0
- package/skills/frontend/nextjs/assets/api-reference/file-conventions/mdx-components.md +84 -0
- package/skills/frontend/nextjs/assets/api-reference/file-conventions/metadata/app-icons.md +302 -0
- package/skills/frontend/nextjs/assets/api-reference/file-conventions/metadata/manifest.md +90 -0
- package/skills/frontend/nextjs/assets/api-reference/file-conventions/metadata/opengraph-image.md +580 -0
- package/skills/frontend/nextjs/assets/api-reference/file-conventions/metadata/robots.md +234 -0
- package/skills/frontend/nextjs/assets/api-reference/file-conventions/metadata/sitemap.md +459 -0
- package/skills/frontend/nextjs/assets/api-reference/file-conventions/not-found.md +278 -0
- package/skills/frontend/nextjs/assets/api-reference/file-conventions/page.md +283 -0
- package/skills/frontend/nextjs/assets/api-reference/file-conventions/parallel-routes.md +517 -0
- package/skills/frontend/nextjs/assets/api-reference/file-conventions/proxy.md +857 -0
- package/skills/frontend/nextjs/assets/api-reference/file-conventions/public-folder.md +47 -0
- package/skills/frontend/nextjs/assets/api-reference/file-conventions/route-groups.md +40 -0
- package/skills/frontend/nextjs/assets/api-reference/file-conventions/route-segment-config/dynamicParams.md +40 -0
- package/skills/frontend/nextjs/assets/api-reference/file-conventions/route-segment-config/ensureStatic.md +195 -0
- package/skills/frontend/nextjs/assets/api-reference/file-conventions/route-segment-config/instant.md +204 -0
- package/skills/frontend/nextjs/assets/api-reference/file-conventions/route-segment-config/maxDuration.md +42 -0
- package/skills/frontend/nextjs/assets/api-reference/file-conventions/route-segment-config/preferredRegion.md +55 -0
- package/skills/frontend/nextjs/assets/api-reference/file-conventions/route-segment-config/prefetch.md +113 -0
- package/skills/frontend/nextjs/assets/api-reference/file-conventions/route-segment-config/runtime.md +43 -0
- package/skills/frontend/nextjs/assets/api-reference/file-conventions/route.md +772 -0
- package/skills/frontend/nextjs/assets/api-reference/file-conventions/src-folder.md +42 -0
- package/skills/frontend/nextjs/assets/api-reference/file-conventions/template.md +174 -0
- package/skills/frontend/nextjs/assets/api-reference/file-conventions/unauthorized.md +143 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/after.md +332 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/cacheLife.md +642 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/cacheTag.md +272 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/catchError.md +267 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/connection.md +114 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/cookies.md +349 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/draft-mode.md +173 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/fetch.md +141 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/forbidden.md +327 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/generate-image-metadata.md +311 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/generate-metadata.md +1510 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/generate-sitemaps.md +102 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/generate-static-params.md +606 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/generate-viewport.md +347 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/headers.md +92 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/image-response.md +225 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/io.md +131 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/navigation.md +220 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/next-request.md +116 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/next-response.md +219 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/next-root-params.md +479 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/not-found.md +269 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/permanentRedirect.md +92 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/prefetch.md +202 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/redirect.md +255 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/refresh.md +91 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/revalidatePath.md +248 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/revalidateTag.md +175 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/unauthorized.md +389 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/unstable_cache.md +131 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/unstable_noStore.md +61 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/unstable_rethrow.md +79 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/updateTag.md +173 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/use-link-status.md +268 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/use-offline.md +222 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/use-params.md +102 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/use-pathname.md +189 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/use-report-web-vitals.md +175 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/use-router.md +214 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/use-search-params.md +416 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/use-selected-layout-segment.md +214 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/use-selected-layout-segments.md +116 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/use-server-inserted-html.md +145 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/userAgent.md +95 -0
- package/skills/frontend/nextjs/assets/api-reference/turbopack.md +552 -0
- package/skills/frontend/nextjs/assets/architecture/accessibility.md +47 -0
- package/skills/frontend/nextjs/assets/architecture/fast-refresh.md +122 -0
- package/skills/frontend/nextjs/assets/architecture/nextjs-compiler.md +376 -0
- package/skills/frontend/nextjs/assets/architecture/supported-browsers.md +146 -0
- package/skills/frontend/nextjs/assets/community/contribution-guide.md +459 -0
- package/skills/frontend/nextjs/assets/community/rspack.md +25 -0
- package/skills/frontend/nextjs/assets/getting-started/caching.md +626 -0
- package/skills/frontend/nextjs/assets/getting-started/css.md +336 -0
- package/skills/frontend/nextjs/assets/getting-started/deploying.md +115 -0
- package/skills/frontend/nextjs/assets/getting-started/error-handling.md +485 -0
- package/skills/frontend/nextjs/assets/getting-started/fetching-data.md +743 -0
- package/skills/frontend/nextjs/assets/getting-started/fonts.md +232 -0
- package/skills/frontend/nextjs/assets/getting-started/images.md +272 -0
- package/skills/frontend/nextjs/assets/getting-started/installation.md +446 -0
- package/skills/frontend/nextjs/assets/getting-started/layouts-and-pages.md +386 -0
- package/skills/frontend/nextjs/assets/getting-started/linking-and-navigating.md +475 -0
- package/skills/frontend/nextjs/assets/getting-started/metadata-and-og-images.md +370 -0
- package/skills/frontend/nextjs/assets/getting-started/mutating-data.md +679 -0
- package/skills/frontend/nextjs/assets/getting-started/project-structure.md +290 -0
- package/skills/frontend/nextjs/assets/getting-started/proxy.md +107 -0
- package/skills/frontend/nextjs/assets/getting-started/revalidating.md +241 -0
- package/skills/frontend/nextjs/assets/getting-started/route-handlers.md +233 -0
- package/skills/frontend/nextjs/assets/getting-started/server-and-client-components.md +683 -0
- package/skills/frontend/nextjs/assets/getting-started/upgrading.md +137 -0
- package/skills/frontend/nextjs/assets/glossary.md +315 -0
- package/skills/frontend/nextjs/evals/nextjsVerification.json +14 -0
- package/skills/frontend/nextjs/references/apiReference.md +3 -0
- package/skills/frontend/nextjs/references/dataAccessLayer.md +39 -0
- package/skills/frontend/nextjs/references/nextjsFeatureMap.md +276 -0
- package/skills/frontend/nextjs/references/productionChecklist.md +49 -0
- package/skills/frontend/nextjs/references/securityHeadersCsp.md +44 -0
- package/skills/frontend/nextjs/scripts/auditProductionReadiness.py +85 -0
- package/skills/frontend/shadcn-ui/SKILL.md +102 -0
- package/skills/frontend/shadcn-ui/assets/README.md +82 -0
- package/skills/frontend/shadcn-ui/assets/advanced/javascript.md +44 -0
- package/skills/frontend/shadcn-ui/assets/advanced/monorepo.md +254 -0
- package/skills/frontend/shadcn-ui/assets/advanced/react-19.md +166 -0
- package/skills/frontend/shadcn-ui/assets/advanced/tailwind-v4.md +333 -0
- package/skills/frontend/shadcn-ui/assets/ai-elements/chain-of-thought.md +519 -0
- package/skills/frontend/shadcn-ui/assets/ai-elements/chat.md +581 -0
- package/skills/frontend/shadcn-ui/assets/ai-elements/checkpoint.md +243 -0
- package/skills/frontend/shadcn-ui/assets/ai-elements/confirmation.md +382 -0
- package/skills/frontend/shadcn-ui/assets/ai-elements/context.md +188 -0
- package/skills/frontend/shadcn-ui/assets/ai-elements/file-tree.md +248 -0
- package/skills/frontend/shadcn-ui/assets/ai-elements/index.md +307 -0
- package/skills/frontend/shadcn-ui/assets/ai-elements/inline-citation.md +219 -0
- package/skills/frontend/shadcn-ui/assets/ai-elements/message.md +298 -0
- package/skills/frontend/shadcn-ui/assets/ai-elements/model-selector.md +368 -0
- package/skills/frontend/shadcn-ui/assets/ai-elements/plan.md +398 -0
- package/skills/frontend/shadcn-ui/assets/ai-elements/prompt-input.md +403 -0
- package/skills/frontend/shadcn-ui/assets/ai-elements/queue.md +517 -0
- package/skills/frontend/shadcn-ui/assets/ai-elements/reasoning.md +349 -0
- package/skills/frontend/shadcn-ui/assets/ai-elements/sources.md +303 -0
- package/skills/frontend/shadcn-ui/assets/ai-elements/stack-trace.md +514 -0
- package/skills/frontend/shadcn-ui/assets/ai-elements/subagent.md +551 -0
- package/skills/frontend/shadcn-ui/assets/ai-elements/suggestion.md +246 -0
- package/skills/frontend/shadcn-ui/assets/ai-elements/task.md +380 -0
- package/skills/frontend/shadcn-ui/assets/ai-elements/terminal.md +463 -0
- package/skills/frontend/shadcn-ui/assets/ai-elements/test-results.md +641 -0
- package/skills/frontend/shadcn-ui/assets/ai-elements/tool.md +915 -0
- package/skills/frontend/shadcn-ui/assets/components/accordion.md +490 -0
- package/skills/frontend/shadcn-ui/assets/components/alert-dialog.md +520 -0
- package/skills/frontend/shadcn-ui/assets/components/alert.md +351 -0
- package/skills/frontend/shadcn-ui/assets/components/aspect-ratio.md +206 -0
- package/skills/frontend/shadcn-ui/assets/components/attachment.md +715 -0
- package/skills/frontend/shadcn-ui/assets/components/avatar.md +581 -0
- package/skills/frontend/shadcn-ui/assets/components/badge.md +276 -0
- package/skills/frontend/shadcn-ui/assets/components/breadcrumb.md +556 -0
- package/skills/frontend/shadcn-ui/assets/components/bubble.md +706 -0
- package/skills/frontend/shadcn-ui/assets/components/button-group.md +969 -0
- package/skills/frontend/shadcn-ui/assets/components/button.md +523 -0
- package/skills/frontend/shadcn-ui/assets/components/calendar.md +959 -0
- package/skills/frontend/shadcn-ui/assets/components/card.md +684 -0
- package/skills/frontend/shadcn-ui/assets/components/carousel.md +643 -0
- package/skills/frontend/shadcn-ui/assets/components/chart.md +1295 -0
- package/skills/frontend/shadcn-ui/assets/components/checkbox.md +553 -0
- package/skills/frontend/shadcn-ui/assets/components/code-block.md +2041 -0
- package/skills/frontend/shadcn-ui/assets/components/collapsible.md +504 -0
- package/skills/frontend/shadcn-ui/assets/components/combobox.md +1102 -0
- package/skills/frontend/shadcn-ui/assets/components/command.md +682 -0
- package/skills/frontend/shadcn-ui/assets/components/context-menu.md +949 -0
- package/skills/frontend/shadcn-ui/assets/components/data-table.md +1667 -0
- package/skills/frontend/shadcn-ui/assets/components/date-picker.md +698 -0
- package/skills/frontend/shadcn-ui/assets/components/dialog.md +454 -0
- package/skills/frontend/shadcn-ui/assets/components/direction.md +205 -0
- package/skills/frontend/shadcn-ui/assets/components/drawer.md +806 -0
- package/skills/frontend/shadcn-ui/assets/components/dropdown-menu.md +1315 -0
- package/skills/frontend/shadcn-ui/assets/components/empty.md +562 -0
- package/skills/frontend/shadcn-ui/assets/components/field.md +1321 -0
- package/skills/frontend/shadcn-ui/assets/components/hover-card.md +342 -0
- package/skills/frontend/shadcn-ui/assets/components/index.md +82 -0
- package/skills/frontend/shadcn-ui/assets/components/input-group.md +980 -0
- package/skills/frontend/shadcn-ui/assets/components/input-otp.md +551 -0
- package/skills/frontend/shadcn-ui/assets/components/input.md +555 -0
- package/skills/frontend/shadcn-ui/assets/components/item.md +937 -0
- package/skills/frontend/shadcn-ui/assets/components/kbd.md +290 -0
- package/skills/frontend/shadcn-ui/assets/components/label.md +327 -0
- package/skills/frontend/shadcn-ui/assets/components/marker.md +445 -0
- package/skills/frontend/shadcn-ui/assets/components/menubar.md +804 -0
- package/skills/frontend/shadcn-ui/assets/components/message-scroller.md +2770 -0
- package/skills/frontend/shadcn-ui/assets/components/message.md +618 -0
- package/skills/frontend/shadcn-ui/assets/components/native-select.md +321 -0
- package/skills/frontend/shadcn-ui/assets/components/navigation-menu.md +568 -0
- package/skills/frontend/shadcn-ui/assets/components/pagination.md +425 -0
- package/skills/frontend/shadcn-ui/assets/components/popover.md +402 -0
- package/skills/frontend/shadcn-ui/assets/components/progress.md +240 -0
- package/skills/frontend/shadcn-ui/assets/components/questionnaire.md +2055 -0
- package/skills/frontend/shadcn-ui/assets/components/radio-group.md +440 -0
- package/skills/frontend/shadcn-ui/assets/components/resizable.md +302 -0
- package/skills/frontend/shadcn-ui/assets/components/scroll-area.md +226 -0
- package/skills/frontend/shadcn-ui/assets/components/select.md +647 -0
- package/skills/frontend/shadcn-ui/assets/components/separator.md +235 -0
- package/skills/frontend/shadcn-ui/assets/components/sheet.md +354 -0
- package/skills/frontend/shadcn-ui/assets/components/sidebar.md +1156 -0
- package/skills/frontend/shadcn-ui/assets/components/skeleton.md +217 -0
- package/skills/frontend/shadcn-ui/assets/components/slider.md +253 -0
- package/skills/frontend/shadcn-ui/assets/components/spinner.md +352 -0
- package/skills/frontend/shadcn-ui/assets/components/switch.md +296 -0
- package/skills/frontend/shadcn-ui/assets/components/table.md +572 -0
- package/skills/frontend/shadcn-ui/assets/components/tabs.md +425 -0
- package/skills/frontend/shadcn-ui/assets/components/textarea.md +218 -0
- package/skills/frontend/shadcn-ui/assets/components/toast.md +260 -0
- package/skills/frontend/shadcn-ui/assets/components/toggle-group.md +419 -0
- package/skills/frontend/shadcn-ui/assets/components/toggle.md +220 -0
- package/skills/frontend/shadcn-ui/assets/components/tooltip.md +332 -0
- package/skills/frontend/shadcn-ui/assets/components/trace.md +1890 -0
- package/skills/frontend/shadcn-ui/assets/components/typography.md +561 -0
- package/skills/frontend/shadcn-ui/assets/dark-mode/next.md +108 -0
- package/skills/frontend/shadcn-ui/assets/dark-mode/overview.md +75 -0
- package/skills/frontend/shadcn-ui/assets/dark-mode/vite.md +144 -0
- package/skills/frontend/shadcn-ui/assets/forms/next.md +716 -0
- package/skills/frontend/shadcn-ui/assets/forms/overview.md +60 -0
- package/skills/frontend/shadcn-ui/assets/forms/react-hook-form.md +2055 -0
- package/skills/frontend/shadcn-ui/assets/forms/tanstack-form.md +2236 -0
- package/skills/frontend/shadcn-ui/assets/installation/astro.md +252 -0
- package/skills/frontend/shadcn-ui/assets/installation/manual.md +255 -0
- package/skills/frontend/shadcn-ui/assets/installation/next.md +256 -0
- package/skills/frontend/shadcn-ui/assets/installation/react-router.md +226 -0
- package/skills/frontend/shadcn-ui/assets/installation/remix.md +52 -0
- package/skills/frontend/shadcn-ui/assets/installation/vite.md +314 -0
- package/skills/frontend/shadcn-ui/assets/mcp/mcp.md +338 -0
- package/skills/frontend/shadcn-ui/assets/overview/changelog.md +6 -0
- package/skills/frontend/shadcn-ui/assets/overview/cli.md +738 -0
- package/skills/frontend/shadcn-ui/assets/overview/components-json.md +379 -0
- package/skills/frontend/shadcn-ui/assets/overview/directory.md +74 -0
- package/skills/frontend/shadcn-ui/assets/overview/introduction.md +77 -0
- package/skills/frontend/shadcn-ui/assets/overview/skills.md +71 -0
- package/skills/frontend/shadcn-ui/assets/overview/theming.md +304 -0
- package/skills/frontend/shadcn-ui/assets/overview/typeset.md +242 -0
- package/skills/frontend/shadcn-ui/assets/registry/getting-started.md +648 -0
- package/skills/frontend/shadcn-ui/assets/registry/overview.md +90 -0
- package/skills/frontend/shadcn-ui/assets/registry/registry-item-json.md +483 -0
- package/skills/frontend/shadcn-ui/assets/registry/registry-json.md +178 -0
- package/skills/frontend/shadcn-ui/evals/componentVerification.json +19 -0
- package/skills/frontend/shadcn-ui/references/aiComponentsCatalog.md +51 -0
- package/skills/frontend/shadcn-ui/references/apiReference.md +3 -0
- package/skills/frontend/shadcn-ui/references/blocksCatalog.md +32 -0
- package/skills/frontend/shadcn-ui/references/cliCommands.md +47 -0
- package/skills/frontend/shadcn-ui/references/componentMarkdownSources.md +48 -0
- package/skills/frontend/shadcn-ui/scripts/fetchComponentDocs.py +43 -0
- package/skills/frontend/tsxReactStandard/SKILL.md +150 -0
- package/skills/frontend/tsxReactStandard/evals/tsxVerification.json +14 -0
- package/skills/frontend/tsxReactStandard/references/apiReference.md +3 -0
- package/skills/frontend/tsxReactStandard/references/discriminatedUnions.md +31 -0
- package/skills/frontend/tsxReactStandard/references/tsconfigStrict.md +36 -0
- package/skills/frontend/tsxReactStandard/scripts/validateTsxTypes.py +44 -0
- package/skills/gitVersionControl/gitWorkflow/SKILL.md +128 -0
- package/skills/gitVersionControl/gitWorkflow/assets/README.md +23 -0
- package/skills/gitVersionControl/gitWorkflow/assets/cli/gh-environment.md +87 -0
- package/skills/gitVersionControl/gitWorkflow/assets/cli/gh-formatting.md +156 -0
- package/skills/gitVersionControl/gitWorkflow/assets/cli/gh-reference.md +2363 -0
- package/skills/gitVersionControl/gitWorkflow/assets/using-git/about-git.md +156 -0
- package/skills/gitVersionControl/gitWorkflow/assets/using-git/about-remote-repositories.md +65 -0
- package/skills/gitVersionControl/gitWorkflow/assets/using-git/associating-text-editors-with-git.md +93 -0
- package/skills/gitVersionControl/gitWorkflow/assets/using-git/caching-your-github-credentials.md +115 -0
- package/skills/gitVersionControl/gitWorkflow/assets/using-git/getting-changes-from-a-remote-repository.md +76 -0
- package/skills/gitVersionControl/gitWorkflow/assets/using-git/ignoring-files.md +51 -0
- package/skills/gitVersionControl/gitWorkflow/assets/using-git/managing-remote-repositories.md +231 -0
- package/skills/gitVersionControl/gitWorkflow/assets/using-git/pushing-commits-to-a-remote-repository.md +119 -0
- package/skills/gitVersionControl/gitWorkflow/evals/evalGitWorkflow.py +43 -0
- package/skills/gitVersionControl/gitWorkflow/references/apiReference.md +3 -0
- package/skills/gitVersionControl/gitWorkflow/references/branchingModels.md +32 -0
- package/skills/gitVersionControl/gitWorkflow/scripts/diagnoseGitGraph.py +68 -0
- package/skills/github/assets/README.md +39 -0
- package/skills/github/assets/cli/gh-environment.md +87 -0
- package/skills/github/assets/cli/gh-formatting.md +156 -0
- package/skills/github/assets/cli/gh-reference.md +2363 -0
- package/skills/github/assets/docs-api/github-docs-api.md +60 -0
- package/skills/github/assets/rest-api/actions-secrets.md +1272 -0
- package/skills/github/assets/rest-api/actions-variables.md +1247 -0
- package/skills/github/assets/rest-api/actions-workflow-runs.md +1697 -0
- package/skills/github/assets/rest-api/actions-workflows.md +348 -0
- package/skills/github/assets/rest-api/authenticating.md +174 -0
- package/skills/github/assets/rest-api/branches.md +727 -0
- package/skills/github/assets/rest-api/checks-runs.md +1013 -0
- package/skills/github/assets/rest-api/checks-suites.md +1142 -0
- package/skills/github/assets/rest-api/code-scanning.md +2957 -0
- package/skills/github/assets/rest-api/collaborators.md +547 -0
- package/skills/github/assets/rest-api/commits.md +957 -0
- package/skills/github/assets/rest-api/dependabot-alerts.md +895 -0
- package/skills/github/assets/rest-api/orgs.md +1172 -0
- package/skills/github/assets/rest-api/overview.md +875 -0
- package/skills/github/assets/rest-api/pull-reviews.md +722 -0
- package/skills/github/assets/rest-api/pulls.md +1605 -0
- package/skills/github/assets/rest-api/quickstart.md +344 -0
- package/skills/github/assets/rest-api/releases.md +650 -0
- package/skills/github/assets/rest-api/repos.md +2957 -0
- package/skills/github/assets/rest-api/rules.md +1507 -0
- package/skills/github/assets/rest-api/secret-scanning.md +947 -0
- package/skills/github/assets/rest-api/teams.md +1690 -0
- package/skills/github/githubAction/SKILL.md +159 -0
- package/skills/github/githubAction/assets/README.md +38 -0
- package/skills/github/githubAction/assets/reference/contexts.md +918 -0
- package/skills/github/githubAction/assets/reference/dependency-caching.md +393 -0
- package/skills/github/githubAction/assets/reference/events-that-trigger-workflows.md +1348 -0
- package/skills/github/githubAction/assets/reference/expressions.md +441 -0
- package/skills/github/githubAction/assets/reference/metadata-syntax.md +803 -0
- package/skills/github/githubAction/assets/reference/variables.md +149 -0
- package/skills/github/githubAction/assets/reference/workflow-cancellation.md +22 -0
- package/skills/github/githubAction/assets/reference/workflow-commands.md +1056 -0
- package/skills/github/githubAction/assets/reference/workflow-syntax.md +1721 -0
- package/skills/github/githubAction/assets/rest-api/secrets.md +1272 -0
- package/skills/github/githubAction/assets/rest-api/workflow-runs.md +1697 -0
- package/skills/github/githubAction/assets/rest-api/workflows.md +348 -0
- package/skills/github/githubAction/assets/starter-workflows/automation/stale.yml +27 -0
- package/skills/github/githubAction/assets/starter-workflows/ci/blank.yml +36 -0
- package/skills/github/githubAction/assets/starter-workflows/ci/docker-image.yml +18 -0
- package/skills/github/githubAction/assets/starter-workflows/ci/go.yml +28 -0
- package/skills/github/githubAction/assets/starter-workflows/ci/maven.yml +35 -0
- package/skills/github/githubAction/assets/starter-workflows/ci/node.js.yml +31 -0
- package/skills/github/githubAction/assets/starter-workflows/ci/python-app.yml +39 -0
- package/skills/github/githubAction/assets/starter-workflows/ci/rust.yml +22 -0
- package/skills/github/githubAction/assets/starter-workflows/code-scanning/codeql.yml +97 -0
- package/skills/github/githubAction/evals/actionVerification.json +14 -0
- package/skills/github/githubAction/references/apiReference.md +3 -0
- package/skills/github/githubAction/references/workflowPatterns.md +81 -0
- package/skills/github/githubAction/scripts/validateWorkflowYaml.py +53 -0
- package/skills/github/githubQuality/SKILL.md +136 -0
- package/skills/github/githubQuality/assets/README.md +24 -0
- package/skills/github/githubQuality/assets/pull-requests/about-code-owners.md +178 -0
- package/skills/github/githubQuality/assets/pull-requests/about-merge-methods.md +48 -0
- package/skills/github/githubQuality/assets/pull-requests/creating-a-pull-request.md +170 -0
- package/skills/github/githubQuality/assets/pull-requests/giving-reviews.md +48 -0
- package/skills/github/githubQuality/assets/pull-requests/managing-a-merge-queue.md +134 -0
- package/skills/github/githubQuality/assets/pull-requests/merging-a-pull-request.md +101 -0
- package/skills/github/githubQuality/assets/pull-requests/resolving-reviews.md +59 -0
- package/skills/github/githubQuality/assets/pull-requests/status-checks.md +135 -0
- package/skills/github/githubQuality/assets/rest-api/checks-runs.md +1013 -0
- package/skills/github/githubQuality/assets/rest-api/checks-suites.md +1142 -0
- package/skills/github/githubQuality/assets/rest-api/commits.md +957 -0
- package/skills/github/githubQuality/assets/rest-api/pulls.md +1605 -0
- package/skills/github/githubQuality/assets/rest-api/reviews.md +722 -0
- package/skills/github/githubQuality/evals/qualityVerification.json +14 -0
- package/skills/github/githubQuality/references/apiReference.md +3 -0
- package/skills/github/githubQuality/references/codeownersExample.md +26 -0
- package/skills/github/githubQuality/references/prTemplate.md +20 -0
- package/skills/github/githubQuality/scripts/auditPrQuality.py +52 -0
- package/skills/github/githubSecurity/SKILL.md +170 -0
- package/skills/github/githubSecurity/assets/README.md +32 -0
- package/skills/github/githubSecurity/assets/code-scanning/code-scanning-alerts.md +133 -0
- package/skills/github/githubSecurity/assets/code-scanning/code-scanning.md +67 -0
- package/skills/github/githubSecurity/assets/code-scanning/codeql-code-scanning.md +79 -0
- package/skills/github/githubSecurity/assets/code-scanning/configure-code-scanning.md +121 -0
- package/skills/github/githubSecurity/assets/dependabot/about-the-dependabot-yml-file.md +74 -0
- package/skills/github/githubSecurity/assets/dependabot/dependabot-alerts.md +133 -0
- package/skills/github/githubSecurity/assets/dependabot/dependabot-security-updates.md +95 -0
- package/skills/github/githubSecurity/assets/dependabot/dependabot-version-updates.md +80 -0
- package/skills/github/githubSecurity/assets/rest-api/code-scanning.md +2957 -0
- package/skills/github/githubSecurity/assets/rest-api/dependabot-alerts.md +895 -0
- package/skills/github/githubSecurity/assets/rest-api/secret-scanning.md +947 -0
- package/skills/github/githubSecurity/assets/secret-scanning/enable-secret-scanning.md +59 -0
- package/skills/github/githubSecurity/assets/secret-scanning/secret-scanning.md +105 -0
- package/skills/github/githubSecurity/assets/security-advisories/github-advisory-database.md +148 -0
- package/skills/github/githubSecurity/evals/securityVerification.json +14 -0
- package/skills/github/githubSecurity/references/apiReference.md +3 -0
- package/skills/github/githubSecurity/references/codeqlAnalysis.yml +42 -0
- package/skills/github/githubSecurity/references/dependabotConfig.yml +27 -0
- package/skills/github/githubSecurity/scripts/auditRepoSecurity.py +47 -0
- package/skills/github/githubSetup/SKILL.md +137 -0
- package/skills/github/githubSetup/assets/README.md +40 -0
- package/skills/github/githubSetup/assets/branches/about-protected-branches.md +198 -0
- package/skills/github/githubSetup/assets/branches/changing-the-default-branch.md +49 -0
- package/skills/github/githubSetup/assets/branches/deleting-and-restoring-branches.md +44 -0
- package/skills/github/githubSetup/assets/branches/managing-a-branch-protection-rule.md +115 -0
- package/skills/github/githubSetup/assets/branches/renaming-a-branch.md +74 -0
- package/skills/github/githubSetup/assets/branches/viewing-branches-in-your-repository.md +30 -0
- package/skills/github/githubSetup/assets/repositories/about-repositories.md +127 -0
- package/skills/github/githubSetup/assets/repositories/cloning-a-repository.md +114 -0
- package/skills/github/githubSetup/assets/repositories/creating-a-new-repository.md +82 -0
- package/skills/github/githubSetup/assets/repositories/creating-a-repository-from-a-template.md +51 -0
- package/skills/github/githubSetup/assets/repositories/deleting-a-repository.md +34 -0
- package/skills/github/githubSetup/assets/repositories/managing-teams-and-people-with-access.md +69 -0
- package/skills/github/githubSetup/assets/repositories/renaming-a-repository.md +47 -0
- package/skills/github/githubSetup/assets/repositories/restoring-a-deleted-repository.md +61 -0
- package/skills/github/githubSetup/assets/repositories/setting-repository-visibility.md +137 -0
- package/skills/github/githubSetup/assets/rest-api/branches.md +727 -0
- package/skills/github/githubSetup/assets/rest-api/quickstart.md +344 -0
- package/skills/github/githubSetup/assets/rest-api/repos.md +2957 -0
- package/skills/github/githubSetup/assets/rulesets/about-rulesets.md +72 -0
- package/skills/github/githubSetup/assets/rulesets/available-rules-for-rulesets.md +383 -0
- package/skills/github/githubSetup/assets/rulesets/converting-branch-protections-to-rulesets.md +92 -0
- package/skills/github/githubSetup/assets/rulesets/creating-rulesets-for-a-repository.md +108 -0
- package/skills/github/githubSetup/assets/rulesets/managing-rulesets-for-a-repository.md +149 -0
- package/skills/github/githubSetup/assets/rulesets/troubleshooting-rules.md +122 -0
- package/skills/github/githubSetup/evals/setupVerification.json +14 -0
- package/skills/github/githubSetup/references/apiReference.md +3 -0
- package/skills/github/githubSetup/references/repoSettingsBlueprint.md +13 -0
- package/skills/github/githubSetup/references/rulesetTemplates.json +42 -0
- package/skills/github/githubSetup/scripts/configureRepoBaseline.py +46 -0
- package/skills/github/githubTeam/SKILL.md +115 -0
- package/skills/github/githubTeam/assets/README.md +21 -0
- package/skills/github/githubTeam/assets/organizations/about-organizations.md +69 -0
- package/skills/github/githubTeam/assets/organizations/repository-roles-for-an-organization.md +94 -0
- package/skills/github/githubTeam/assets/rest-api/collaborators.md +547 -0
- package/skills/github/githubTeam/assets/rest-api/orgs.md +1172 -0
- package/skills/github/githubTeam/assets/rest-api/teams.md +1690 -0
- package/skills/github/githubTeam/assets/teams/about-teams.md +82 -0
- package/skills/github/githubTeam/assets/teams/adding-members-to-a-team.md +55 -0
- package/skills/github/githubTeam/evals/teamVerification.json +14 -0
- package/skills/github/githubTeam/references/apiReference.md +3 -0
- package/skills/github/githubTeam/references/permissionMatrix.md +17 -0
- package/skills/github/githubTeam/references/reviewAssignment.md +17 -0
- package/skills/github/githubTeam/scripts/manageTeamSync.py +31 -0
- package/skills/securityQa/llmSecurityRedteaming/SKILL.md +86 -0
- package/skills/securityQa/llmSecurityRedteaming/evals/securityRedteamVerification.json +14 -0
- package/skills/securityQa/llmSecurityRedteaming/references/apiReference.md +3 -0
- package/skills/securityQa/llmSecurityRedteaming/references/jailbreakTaxonomy.md +6 -0
- package/skills/securityQa/llmSecurityRedteaming/references/owaspLlmTopTen.md +12 -0
- package/skills/securityQa/llmSecurityRedteaming/scripts/testPromptInjection.py +34 -0
- package/skills/softwareDevelopment/requirementsEngineering/SKILL.md +110 -0
- package/skills/softwareDevelopment/requirementsEngineering/evals/evalRequirements.py +33 -0
- package/skills/softwareDevelopment/requirementsEngineering/references/apiReference.md +3 -0
- package/skills/softwareDevelopment/requirementsEngineering/references/requirementsAnalysisModels.md +34 -0
- package/skills/softwareDevelopment/requirementsEngineering/scripts/validateUserStories.py +49 -0
- package/skills/testing/testDrivenDevelopment/SKILL.md +122 -0
- package/skills/testing/testDrivenDevelopment/evals/evalTdd.py +25 -0
- package/skills/testing/testDrivenDevelopment/references/apiReference.md +3 -0
- package/skills/testing/testDrivenDevelopment/references/testPyramidDoubles.md +35 -0
- package/skills/testing/testDrivenDevelopment/scripts/auditTestPyramid.py +58 -0
|
@@ -0,0 +1,276 @@
|
|
|
1
|
+
# Next.js App Router — Exhaustive Feature & Sidebar Architecture Map (v16.4.6)
|
|
2
|
+
|
|
3
|
+
> Complete structured catalog and feature map for the Next.js App Router documentation (`https://nextjs.org/docs/app`). Every item maps directly to official raw markdown endpoints (`.md`) and Next.js docs URLs.
|
|
4
|
+
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
## 1. Getting Started (18 Core Modules)
|
|
8
|
+
|
|
9
|
+
| Feature | Category | Raw Markdown URL | Description |
|
|
10
|
+
|---|---|---|---|
|
|
11
|
+
| **Installation** | Setup | `https://nextjs.org/docs/app/getting-started/installation.md` | Create a new application with `create-next-app` CLI, configure TypeScript, ESLint, and path aliases. |
|
|
12
|
+
| **Project Structure** | Conventions | `https://nextjs.org/docs/app/getting-started/project-structure.md` | Complete folder/file conventions, special routing files, private folders (`_folder`), and route groups `(group)`. |
|
|
13
|
+
| **Layouts and Pages** | Routing | `https://nextjs.org/docs/app/getting-started/layouts-and-pages.md` | Define root and nested layouts, pages, layout persistence, state preservation, and client navigation with `<Link>`. |
|
|
14
|
+
| **Linking and Navigating** | Navigation | `https://nextjs.org/docs/app/getting-started/linking-and-navigating.md` | Built-in navigation optimizations: prefetching, prerendering, soft navigation, and slow network strategies. |
|
|
15
|
+
| **Server & Client Components** | Architecture | `https://nextjs.org/docs/app/getting-started/server-and-client-components.md` | React Server Components (RSC) vs Client Components (`"use client"`), network boundary, serialization over Flight RPC. |
|
|
16
|
+
| **Fetching Data** | Data | `https://nextjs.org/docs/app/getting-started/fetching-data.md` | Server Component data fetching, async components, streaming with `<Suspense>`, parallel queries, and waterfalls. |
|
|
17
|
+
| **Mutating Data** | Data | `https://nextjs.org/docs/app/getting-started/mutating-data.md` | Server Functions & Server Actions (`"use server"`), form submissions, pending states, optimistic updates. |
|
|
18
|
+
| **Caching** | Caching | `https://nextjs.org/docs/app/getting-started/caching.md` | Multi-layer caching architecture (Request Memoization, Data Cache, Full Route Cache, Router Cache). |
|
|
19
|
+
| **Revalidating** | Caching | `https://nextjs.org/docs/app/getting-started/revalidating.md` | Time-based (stale-while-revalidate) and on-demand cache revalidation via tags and paths. |
|
|
20
|
+
| **Error Handling** | Resilience | `https://nextjs.org/docs/app/getting-started/error-handling.md` | Expected error handling, `error.tsx` boundaries, `global-error.tsx`, and unhandled exception triage. |
|
|
21
|
+
| **CSS & Styling** | Styling | `https://nextjs.org/docs/app/getting-started/css.md` | Tailwind CSS, CSS Modules, Global CSS, Sass, external stylesheets, and CSS chunking. |
|
|
22
|
+
| **Image Optimization** | Assets | `https://nextjs.org/docs/app/getting-started/images.md` | Built-in `next/image`, responsive sizing, layout shift prevention (CLS), modern formats (WebP/AVIF), and priority loading. |
|
|
23
|
+
| **Font Optimization** | Assets | `https://nextjs.org/docs/app/getting-started/fonts.md` | Zero layout-shift self-hosted web fonts via `next/font/google` and `next/font/local`. |
|
|
24
|
+
| **Metadata and OG Images** | SEO | `https://nextjs.org/docs/app/getting-started/metadata-and-og-images.md` | Static & dynamic SEO metadata (`generateMetadata`), social cards, OpenGraph, and dynamic OG image generation. |
|
|
25
|
+
| **Route Handlers** | API | `https://nextjs.org/docs/app/getting-started/route-handlers.md` | Custom backend endpoints (`route.ts`) built on Web Standard `Request` and `Response` APIs. |
|
|
26
|
+
| **Proxy (Middleware Evolution)** | Network | `https://nextjs.org/docs/app/getting-started/proxy.md` | Intercept incoming requests, rewrite, redirect, modify headers, or respond before request completion. |
|
|
27
|
+
| **Deploying** | DevOps | `https://nextjs.org/docs/app/getting-started/deploying.md` | Deployment workflows: managed hosting (Vercel), Node.js server, Docker containers, and static exports. |
|
|
28
|
+
| **Upgrading** | Lifecycle | `https://nextjs.org/docs/app/getting-started/upgrading.md` | Upgrading Next.js versions, canary builds, codemods, and automated AI coding agent upgrades. |
|
|
29
|
+
|
|
30
|
+
---
|
|
31
|
+
|
|
32
|
+
## 2. Guides (Comprehensive Use Cases & Production Patterns)
|
|
33
|
+
|
|
34
|
+
| Topic | Raw Markdown URL | Description |
|
|
35
|
+
|---|---|---|
|
|
36
|
+
| **Adopting Partial Prefetching** | `https://nextjs.org/docs/app/guides/adopting-partial-prefetching.md` | Enable Partial Prefetching (PPR) and understand `<Link>` behavior changes. |
|
|
37
|
+
| **AI Coding Agents** | `https://nextjs.org/docs/app/guides/ai-agents.md` | Framework integration for AI agents, built-in docs inspection, verification, and issue triage. |
|
|
38
|
+
| **Analytics & Web Vitals** | `https://nextjs.org/docs/app/guides/analytics.md` | Track Core Web Vitals (LCP, FID/INP, CLS) with Speed Insights and custom reporters. |
|
|
39
|
+
| **Authentication** | `https://nextjs.org/docs/app/guides/authentication.md` | Session management, cookie validation, Server Actions auth, and route protection. |
|
|
40
|
+
| **Authentication with Cache Components** | `https://nextjs.org/docs/app/guides/authentication-with-cache-components.md` | Read user sessions without blocking static shells, caching user-derived states safely. |
|
|
41
|
+
| **Backend for Frontend (BFF)** | `https://nextjs.org/docs/app/guides/backend-for-frontend.md` | Architecture patterns using Next.js as an enterprise backend aggregation layer. |
|
|
42
|
+
| **Building (`next build`)** | `https://nextjs.org/docs/app/guides/building.md` | Deep dive into build lifecycle, asset tracing, static prerendering, and output logs. |
|
|
43
|
+
| **Caching (Legacy Model)** | `https://nextjs.org/docs/app/guides/caching-without-cache-components.md` | Classic fetch options, `unstable_cache`, and segment configs without Cache Components. |
|
|
44
|
+
| **CDN Caching** | `https://nextjs.org/docs/app/guides/cdn-caching.md` | Pathname-based edge keying, cache variability, and CDN invalidation. |
|
|
45
|
+
| **CI Build Caching** | `https://nextjs.org/docs/app/guides/ci-build-caching.md` | Persistent `.next/cache` restoration across GitHub Actions and CI pipelines. |
|
|
46
|
+
| **Client-Side Data Fetching (SWR)** | `https://nextjs.org/docs/app/guides/client-side-data-fetching/swr.md` | Coordinate client-side SWR caching with Server Component initial data hydration. |
|
|
47
|
+
| **Client-Side Data Fetching (TanStack Query)** | `https://nextjs.org/docs/app/guides/client-side-data-fetching/tanstack-query.md` | Prefetching in RSC and dehydrating state into TanStack Query client providers. |
|
|
48
|
+
| **Content Security Policy (CSP)** | `https://nextjs.org/docs/app/guides/content-security-policy.md` | Strict nonce generation in middleware, CSP headers, inline script protection. |
|
|
49
|
+
| **CSS-in-JS** | `https://nextjs.org/docs/app/guides/css-in-js.md` | Integrating styled-components, Emotion, and style registries with streaming RSC. |
|
|
50
|
+
| **Custom Server** | `https://nextjs.org/docs/app/guides/custom-server.md` | Running custom Express, Fastify, or Node HTTP servers with Next.js programmatic API. |
|
|
51
|
+
| **Data Security & Taint API** | `https://nextjs.org/docs/app/guides/data-security.md` | React Taint APIs (`taintObjectReference`, `taintUniqueValue`) and Data Access Layer boundaries. |
|
|
52
|
+
| **Debugging** | `https://nextjs.org/docs/app/guides/debugging.md` | Source maps, VS Code launch configurations, Chrome/Firefox DevTools inspection. |
|
|
53
|
+
| **Deploying to Platforms** | `https://nextjs.org/docs/app/guides/deploying-to-platforms.md` | Feature matrix across deployment platforms (streaming, image optimization, edge vs node). |
|
|
54
|
+
| **Draft Mode** | `https://nextjs.org/docs/app/guides/draft-mode.md` | Bypass static caching for headless CMS live preview workflows. |
|
|
55
|
+
| **Environment Variables** | `https://nextjs.org/docs/app/guides/environment-variables.md` | `.env.production`, `.env.local`, build-time embedding vs runtime server variables. |
|
|
56
|
+
| **Forms & Server Actions** | `https://nextjs.org/docs/app/guides/forms.md` | Progressive enhancement, `useActionState`, `useFormStatus`, validation, and pending states. |
|
|
57
|
+
| **How Revalidation Works** | `https://nextjs.org/docs/app/guides/how-revalidation-works.md` | Invalidation tags, cache consistency, stale-while-revalidate, and multi-instance sync. |
|
|
58
|
+
| **Incremental Static Regeneration (ISR)** | `https://nextjs.org/docs/app/guides/incremental-static-regeneration.md` | Static page creation/regeneration at runtime without rebuilding the entire app. |
|
|
59
|
+
| **ISR with Cache Components** | `https://nextjs.org/docs/app/guides/incremental-static-regeneration-cache-components.md` | Prerender dynamic subsets, serve instant App Shells, and revalidate in background. |
|
|
60
|
+
| **Instant Navigation** | `https://nextjs.org/docs/app/guides/instant-navigation.md` | Optimize prefetching and prerendering for zero-latency client-side transitions. |
|
|
61
|
+
| **Instrumentation** | `https://nextjs.org/docs/app/guides/instrumentation.md` | `register()` lifecycle hook executed once on server startup for telemetry and monitors. |
|
|
62
|
+
| **Interactive Apps** | `https://nextjs.org/docs/app/guides/interactive-apps.md` | High-fidelity interactive UI with transitions (`useTransition`), optimistic UI, and feedback. |
|
|
63
|
+
| **Internationalization (i18n)** | `https://nextjs.org/docs/app/guides/internationalization.md` | Sub-path routing `/[lang]/`, locale detection, and dictionary translations. |
|
|
64
|
+
| **JSON-LD** | `https://nextjs.org/docs/app/guides/json-ld.md` | Structured data injection in RSC for search engines and rich snippets. |
|
|
65
|
+
| **Keeping Pages Static** | `https://nextjs.org/docs/app/guides/keeping-pages-static.md` | Prevent unintentional dynamic bailing and enforce route staticness. |
|
|
66
|
+
| **Lazy Loading** | `https://nextjs.org/docs/app/guides/lazy-loading.md` | Dynamic imports (`next/dynamic`), `React.lazy`, and client component code-splitting. |
|
|
67
|
+
| **Local Development** | `https://nextjs.org/docs/app/guides/local-development.md` | Optimizing local dev server, Turbopack startup, HMR latency, and memory footprints. |
|
|
68
|
+
| **Next.js MCP Server** | `https://nextjs.org/docs/app/guides/mcp.md` | Built-in Model Context Protocol endpoint for coding agents to inspect live running state. |
|
|
69
|
+
| **MDX** | `https://nextjs.org/docs/app/guides/mdx.md` | Markdown + JSX compilation via `@next/mdx` or Rust-based `mdxRs`. |
|
|
70
|
+
| **Memory Usage** | `https://nextjs.org/docs/app/guides/memory-usage.md` | Memory profiling, heap snapshots, and leak prevention in Node.js production servers. |
|
|
71
|
+
| **Migrating: Pages to App Router** | `https://nextjs.org/docs/app/guides/migrating/app-router-migration.md` | Incremental co-existence and migration from `pages/` to `app/`. |
|
|
72
|
+
| **Migrating: Create React App** | `https://nextjs.org/docs/app/guides/migrating/from-create-react-app.md` | Migrating legacy CRA single-page applications to Next.js. |
|
|
73
|
+
| **Migrating: Vite** | `https://nextjs.org/docs/app/guides/migrating/from-vite.md` | Migrating Vite SPA or SSR architectures to the App Router. |
|
|
74
|
+
| **Migrating to Cache Components** | `https://nextjs.org/docs/app/guides/migrating-to-cache-components.md` | Transition from segment config flags to `"use cache"` and `cacheLife`. |
|
|
75
|
+
| **Multi-Tenant Architecture** | `https://nextjs.org/docs/app/guides/multi-tenant.md` | Custom domains, wildcard subdomains, and dynamic tenant routing. |
|
|
76
|
+
| **Multi-Zones** | `https://nextjs.org/docs/app/guides/multi-zones.md` | Micro-frontend routing across multiple independent Next.js applications under one domain. |
|
|
77
|
+
| **Offline Support** | `https://nextjs.org/docs/app/guides/offline-support.md` | Graceful recovery on network disconnection, offline flags, and retry strategies. |
|
|
78
|
+
| **OpenTelemetry (OTel)** | `https://nextjs.org/docs/app/guides/open-telemetry.md` | Tracing spans, metrics export, and distributed observability across services. |
|
|
79
|
+
| **Optimizing Prefetching** | `https://nextjs.org/docs/app/guides/optimizing-prefetching.md` | Fine-tuning `<Link prefetch={...}>`, viewport observers, and background payloads. |
|
|
80
|
+
| **Optimizing the Static Shell** | `https://nextjs.org/docs/app/guides/optimizing-the-static-shell.md` | App shell architecture, instant header/navigation render, and deferred data streaming. |
|
|
81
|
+
| **Package Bundling & Analyzer** | `https://nextjs.org/docs/app/guides/package-bundling.md` | Bundle size breakdown using `@next/bundle-analyzer` and Turbopack analysis tools. |
|
|
82
|
+
| **PPR Platform Guide** | `https://nextjs.org/docs/app/guides/ppr-platform-guide.md` | Platform and infrastructure specifications for hosting Partial Prerendering. |
|
|
83
|
+
| **Preserving UI State** | `https://nextjs.org/docs/app/guides/preserving-ui-state.md` | React `Activity` component and layout state preservation across client transitions. |
|
|
84
|
+
| **Preventing FOUC** | `https://nextjs.org/docs/app/guides/preventing-flash-before-hydration.md` | Eliminating flash of unstyled theme content (dark mode) prior to hydration. |
|
|
85
|
+
| **Production Checklist** | `https://nextjs.org/docs/app/guides/production-checklist.md` | Official pre-launch verification: caching, security, performance, fonts, and logging. |
|
|
86
|
+
| **Progressive Web Apps (PWA)** | `https://nextjs.org/docs/app/guides/progressive-web-apps.md` | Service workers, web app manifests, and offline installability. |
|
|
87
|
+
| **Public Static Pages** | `https://nextjs.org/docs/app/guides/public-static-pages.md` | Highly scalable shared static content (marketing, catalogs, blogs). |
|
|
88
|
+
| **Redirecting** | `https://nextjs.org/docs/app/guides/redirecting.md` | Server-side `redirect()`, `permanentRedirect()`, `next.config.js` rewrites, and client hooks. |
|
|
89
|
+
| **Rendering Philosophy** | `https://nextjs.org/docs/app/guides/rendering-philosophy.md` | The component-level spectrum between fully static, partially cached, and purely dynamic rendering. |
|
|
90
|
+
| **Self-Hosting** | `https://nextjs.org/docs/app/guides/self-hosting.md` | Docker multi-stage builds, Node server clusters, static exports, and reverse proxying (NGINX/Caddy). |
|
|
91
|
+
| **Server Actions Deep Dive** | `https://nextjs.org/docs/app/guides/server-actions.md` | Single-roundtrip mutation model, sequential queuing, and CSRF protection. |
|
|
92
|
+
| **Server/Client Boundary** | `https://nextjs.org/docs/app/guides/server-and-client-boundary.md` | Rules for passing props across the boundary, serialization, and children composition pattern. |
|
|
93
|
+
| **Single Page Applications (SPAs)** | `https://nextjs.org/docs/app/guides/single-page-applications.md` | Building fast SPA experiences with App Router client-side routing. |
|
|
94
|
+
| **Static Exports (`next export`)** | `https://nextjs.org/docs/app/guides/static-exports.md` | `output: 'export'` generation for S3, Cloudflare Pages, or static web servers. |
|
|
95
|
+
| **Streaming UI** | `https://nextjs.org/docs/app/guides/streaming.md` | Progressive rendering via React Suspense and HTTP/2 chunked transfer encoding. |
|
|
96
|
+
| **Testing (E2E & Unit)** | `https://nextjs.org/docs/app/guides/testing.md` | Vitest, Jest, Cypress, and Playwright configurations with RSC and App Router. |
|
|
97
|
+
| **Third-Party Libraries** | `https://nextjs.org/docs/app/guides/third-party-libraries.md` | `@next/third-parties` for Google Tag Manager, Analytics, YouTube, and Google Maps. |
|
|
98
|
+
| **View Transitions** | `https://nextjs.org/docs/app/guides/view-transitions.md` | Native browser View Transitions API integration during route navigations. |
|
|
99
|
+
|
|
100
|
+
---
|
|
101
|
+
|
|
102
|
+
## 3. API Reference: Directives & Components
|
|
103
|
+
|
|
104
|
+
### A. Directives
|
|
105
|
+
| Directive | Raw Markdown URL | Purpose |
|
|
106
|
+
|---|---|---|
|
|
107
|
+
| `"use client"` | `https://nextjs.org/docs/app/api-reference/directives/use-client.md` | Declares a boundary between Server and Client component trees. Required for React hooks and DOM listeners. |
|
|
108
|
+
| `"use server"` | `https://nextjs.org/docs/app/api-reference/directives/use-server.md` | Marks a function or module as callable from the client (Server Actions / Server Functions). |
|
|
109
|
+
| `"use cache"` | `https://nextjs.org/docs/app/api-reference/directives/use-cache.md` | Next.js 15+ Cache Component directive to mark asynchronous functions or components for automatic caching. |
|
|
110
|
+
| `"use cache: private"` | `https://nextjs.org/docs/app/api-reference/directives/use-cache-private.md` | Caches functions that access runtime request APIs (e.g. user session tokens) in private isolated contexts. |
|
|
111
|
+
| `"use cache: remote"` | `https://nextjs.org/docs/app/api-reference/directives/use-cache-remote.md` | Enables persistent, distributed cache handlers for multi-instance deployments. |
|
|
112
|
+
|
|
113
|
+
### B. Built-in Components
|
|
114
|
+
| Component | Raw Markdown URL | Key Capabilities |
|
|
115
|
+
|---|---|---|
|
|
116
|
+
| `<Image>` | `https://nextjs.org/docs/app/api-reference/components/image.md` | Automatic format negotiation (WebP/AVIF), intrinsic aspect ratio reservation, lazy loading, blur placeholder. |
|
|
117
|
+
| `<Link>` | `https://nextjs.org/docs/app/api-reference/components/link.md` | Fast client-side transitions, viewport prefetching, scroll restoration, and shallow routing. |
|
|
118
|
+
| `<Form>` | `https://nextjs.org/docs/app/api-reference/components/form.md` | Progressive form submission with client-side navigation and search parameter syncing. |
|
|
119
|
+
| `<Script>` | `https://nextjs.org/docs/app/api-reference/components/script.md` | Fine-grained 3rd party script loading strategies: `beforeInteractive`, `afterInteractive`, `lazyOnload`, `worker`. |
|
|
120
|
+
| `next/font` | `https://nextjs.org/docs/app/api-reference/components/font.md` | Built-in font loaders with automated CSS variable binding and zero Cumulative Layout Shift. |
|
|
121
|
+
|
|
122
|
+
---
|
|
123
|
+
|
|
124
|
+
## 4. API Reference: File-System Conventions
|
|
125
|
+
|
|
126
|
+
### A. Route Files
|
|
127
|
+
| File Name | Scope | Raw Markdown URL | Description |
|
|
128
|
+
|---|---|---|---|
|
|
129
|
+
| `layout.tsx` | Shared | `https://nextjs.org/docs/app/api-reference/file-conventions/layout.md` | Shared UI across route segments. Preserves state and does not re-render on navigation. |
|
|
130
|
+
| `page.tsx` | Unique | `https://nextjs.org/docs/app/api-reference/file-conventions/page.md` | Unique UI of a route segment. Makes the route publicly accessible. |
|
|
131
|
+
| `loading.tsx` | Segment | `https://nextjs.org/docs/app/api-reference/file-conventions/loading.md` | Instant loading state automatically wrapped in React Suspense boundary. |
|
|
132
|
+
| `not-found.tsx` | Segment | `https://nextjs.org/docs/app/api-reference/file-conventions/not-found.md` | Triggered by `notFound()` or unmatched routes within the segment. |
|
|
133
|
+
| `error.tsx` | Segment | `https://nextjs.org/docs/app/api-reference/file-conventions/error.md` | React error boundary for route segment (`"use client"`). Recovers with `reset()`. |
|
|
134
|
+
| `global-error.tsx` | Root | `https://nextjs.org/docs/app/api-reference/file-conventions/error.md` | Top-level catch-all error boundary replacing the root layout on catastrophic failure. |
|
|
135
|
+
| `route.ts` | Backend | `https://nextjs.org/docs/app/api-reference/file-conventions/route.md` | Backend API handler (GET, POST, PUT, PATCH, DELETE, OPTIONS, HEAD). |
|
|
136
|
+
| `template.tsx` | Segment | `https://nextjs.org/docs/app/api-reference/file-conventions/template.md` | Like layout, but creates a new instance and resets state on every navigation. |
|
|
137
|
+
| `default.tsx` | Slot | `https://nextjs.org/docs/app/api-reference/file-conventions/default.md` | Fallback component rendered inside parallel route slots (`@slot`) on page reloads. |
|
|
138
|
+
| `forbidden.tsx` | Segment | `https://nextjs.org/docs/app/api-reference/file-conventions/forbidden.md` | UI displayed when `forbidden()` is thrown (requires `authInterrupts`). |
|
|
139
|
+
| `unauthorized.tsx` | Segment | `https://nextjs.org/docs/app/api-reference/file-conventions/unauthorized.md` | UI displayed when `unauthorized()` is thrown (requires `authInterrupts`). |
|
|
140
|
+
| `proxy.ts` | Network | `https://nextjs.org/docs/app/api-reference/file-conventions/proxy.md` | Next.js Proxy request interceptor (evolved middleware pattern). |
|
|
141
|
+
| `instrumentation.ts` | Server | `https://nextjs.org/docs/app/api-reference/file-conventions/instrumentation.md` | Server initialization code run when the Next.js Node/Edge server boots up. |
|
|
142
|
+
| `instrumentation-client.ts` | Client | `https://nextjs.org/docs/app/api-reference/file-conventions/instrumentation-client.md` | Client-side frontend telemetry and performance monitoring initialization. |
|
|
143
|
+
|
|
144
|
+
### B. Dynamic & Parallel Routing Conventions
|
|
145
|
+
| Pattern | Syntax | Raw Markdown URL | Purpose |
|
|
146
|
+
|---|---|---|---|
|
|
147
|
+
| Dynamic Segment | `[slug]` | `https://nextjs.org/docs/app/api-reference/file-conventions/dynamic-routes.md` | Matches a single dynamic URL path parameter. |
|
|
148
|
+
| Catch-All Segment | `[...slug]` | `https://nextjs.org/docs/app/api-reference/file-conventions/dynamic-routes.md` | Matches all subsequent path segments into an array. |
|
|
149
|
+
| Optional Catch-All | `[[...slug]]` | `https://nextjs.org/docs/app/api-reference/file-conventions/dynamic-routes.md` | Matches the route with or without additional path segments. |
|
|
150
|
+
| Route Groups | `(marketing)` | `https://nextjs.org/docs/app/api-reference/file-conventions/route-groups.md` | Organizes routes into logical folders without affecting the URL path. |
|
|
151
|
+
| Parallel Routes | `@analytics` | `https://nextjs.org/docs/app/api-reference/file-conventions/parallel-routes.md` | Simultaneously renders multiple independent pages into named layout slots. |
|
|
152
|
+
| Intercepting Routes | `(.)photo`, `(..)` | `https://nextjs.org/docs/app/api-reference/file-conventions/intercepting-routes.md` | Loads a route within the current layout (e.g. modal overlay) while masking URL. |
|
|
153
|
+
|
|
154
|
+
### C. Metadata Files
|
|
155
|
+
| File | Raw Markdown URL | Description |
|
|
156
|
+
|---|---|---|
|
|
157
|
+
| `sitemap.xml` / `sitemap.ts` | `https://nextjs.org/docs/app/api-reference/file-conventions/metadata/sitemap.md` | XML sitemap generator supporting multi-sitemap indexing. |
|
|
158
|
+
| `robots.txt` / `robots.ts` | `https://nextjs.org/docs/app/api-reference/file-conventions/metadata/robots.md` | Search crawler indexing instructions and sitemap discovery rules. |
|
|
159
|
+
| `opengraph-image.tsx` | `https://nextjs.org/docs/app/api-reference/file-conventions/metadata/opengraph-image.md` | Dynamically generated Open Graph & Twitter social card images via JSX/Satori. |
|
|
160
|
+
| `manifest.json` / `manifest.ts` | `https://nextjs.org/docs/app/api-reference/file-conventions/metadata/manifest.md` | Web App Manifest for Progressive Web Apps (PWAs). |
|
|
161
|
+
| `favicon.ico`, `icon.png`, `apple-icon.png` | `https://nextjs.org/docs/app/api-reference/file-conventions/metadata/app-icons.md` | Static or programmatic favicon and application touch icons. |
|
|
162
|
+
|
|
163
|
+
### D. Route Segment Config Options
|
|
164
|
+
| Option | Raw Markdown URL | Typical Values |
|
|
165
|
+
|---|---|---|
|
|
166
|
+
| `dynamic` | `https://nextjs.org/docs/app/api-reference/file-conventions/route-segment-config.md` | `'auto' \| 'force-dynamic' \| 'error' \| 'force-static'` |
|
|
167
|
+
| `dynamicParams` | `https://nextjs.org/docs/app/api-reference/file-conventions/route-segment-config/dynamicParams.md` | `true \| false` (controls 404 on ungenerated static params) |
|
|
168
|
+
| `revalidate` | `https://nextjs.org/docs/app/api-reference/file-conventions/route-segment-config.md` | `false \| 0 \| number` (seconds for ISR) |
|
|
169
|
+
| `runtime` | `https://nextjs.org/docs/app/api-reference/file-conventions/route-segment-config/runtime.md` | `'nodejs' \| 'edge'` |
|
|
170
|
+
| `maxDuration` | `https://nextjs.org/docs/app/api-reference/file-conventions/route-segment-config/maxDuration.md` | Number (timeout execution in seconds for serverless functions) |
|
|
171
|
+
| `ensureStatic` | `https://nextjs.org/docs/app/api-reference/file-conventions/route-segment-config/ensureStatic.md` | Enforces that route output remains strictly static during build. |
|
|
172
|
+
| `instant` | `https://nextjs.org/docs/app/api-reference/file-conventions/route-segment-config/instant.md` | Validates instant navigation compliance for route segments. |
|
|
173
|
+
| `prefetch` | `https://nextjs.org/docs/app/api-reference/file-conventions/route-segment-config/prefetch.md` | Configures segment-level prefetch bundling during client navigation. |
|
|
174
|
+
|
|
175
|
+
---
|
|
176
|
+
|
|
177
|
+
## 5. API Reference: Functions and Hooks (Complete Index)
|
|
178
|
+
|
|
179
|
+
| Function / Hook | Environment | Raw Markdown URL | Description |
|
|
180
|
+
|---|---|---|---|
|
|
181
|
+
| **`after(callback)`** | Server | `https://nextjs.org/docs/app/api-reference/functions/after.md` | Schedules non-blocking work (logging, analytics) to execute after the response closes. |
|
|
182
|
+
| **`cacheLife(profile)`** | Server | `https://nextjs.org/docs/app/api-reference/functions/cacheLife.md` | Configures cache expiration thresholds (`stale`, `revalidate`, `expire`) inside `"use cache"`. |
|
|
183
|
+
| **`cacheTag(...tags)`** | Server | `https://nextjs.org/docs/app/api-reference/functions/cacheTag.md` | Attaches cache invalidation tags to functions or components wrapped with `"use cache"`. |
|
|
184
|
+
| **`revalidateTag(tag)`** | Server | `https://nextjs.org/docs/app/api-reference/functions/revalidateTag.md` | Purges all cached entries matching the specified cache tag. |
|
|
185
|
+
| **`revalidatePath(path)`** | Server | `https://nextjs.org/docs/app/api-reference/functions/revalidatePath.md` | Purges cached data and UI associated with a specific route path. |
|
|
186
|
+
| **`updateTag(tag)`** | Server | `https://nextjs.org/docs/app/api-reference/functions/updateTag.md` | Revalidates and updates cache tags in real-time. |
|
|
187
|
+
| **`cookies()`** | Server | `https://nextjs.org/docs/app/api-reference/functions/cookies.md` | Read, set, and delete incoming request cookies in Server Components or Actions. |
|
|
188
|
+
| **`headers()`** | Server | `https://nextjs.org/docs/app/api-reference/functions/headers.md` | Read incoming HTTP headers inside Server Components. |
|
|
189
|
+
| **`connection()`** | Server | `https://nextjs.org/docs/app/api-reference/functions/connection.md` | Explicitly declares a dependency on incoming request connection (opts into dynamic rendering). |
|
|
190
|
+
| **`notFound()`** | Server | `https://nextjs.org/docs/app/api-reference/functions/not-found.md` | Throws a 404 response and renders the nearest `not-found.tsx` boundary. |
|
|
191
|
+
| **`redirect(url)`** | Server | `https://nextjs.org/docs/app/api-reference/functions/redirect.md` | Performs an HTTP 307 redirect within Server Components or Server Actions. |
|
|
192
|
+
| **`permanentRedirect(url)`** | Server | `https://nextjs.org/docs/app/api-reference/functions/permanentRedirect.md` | Performs an HTTP 308 permanent redirect. |
|
|
193
|
+
| **`forbidden()`** | Server | `https://nextjs.org/docs/app/api-reference/functions/forbidden.md` | Throws an HTTP 403 response and renders `forbidden.tsx`. |
|
|
194
|
+
| **`unauthorized()`** | Server | `https://nextjs.org/docs/app/api-reference/functions/unauthorized.md` | Throws an HTTP 401 response and renders `unauthorized.tsx`. |
|
|
195
|
+
| **`generateMetadata(props)`** | Server | `https://nextjs.org/docs/app/api-reference/functions/generate-metadata.md` | Computes dynamic SEO `<title>`, `<meta>`, OpenGraph, and JSON-LD tags. |
|
|
196
|
+
| **`generateViewport(props)`** | Server | `https://nextjs.org/docs/app/api-reference/functions/generate-viewport.md` | Dynamic configuration for viewport meta tag (`themeColor`, `width`, `initialScale`). |
|
|
197
|
+
| **`generateStaticParams()`** | Server | `https://nextjs.org/docs/app/api-reference/functions/generate-static-params.md` | Pre-renders dynamic route segments at build time for static generation. |
|
|
198
|
+
| **`generateImageMetadata()`** | Server | `https://nextjs.org/docs/app/api-reference/functions/generate-image-metadata.md` | Generates multiple OG images from a single special file. |
|
|
199
|
+
| **`generateSitemaps()`** | Server | `https://nextjs.org/docs/app/api-reference/functions/generate-sitemaps.md` | Splits large application sitemaps into multiple indexed XML files. |
|
|
200
|
+
| **`draftMode()`** | Server | `https://nextjs.org/docs/app/api-reference/functions/draft-mode.md` | Inspects and toggles draft mode cookies for headless CMS previewing. |
|
|
201
|
+
| **`unstable_cache(fn, keys, opts)`** | Server | `https://nextjs.org/docs/app/api-reference/functions/unstable_cache.md` | Low-level caching wrapper for caching expensive async function results across requests. |
|
|
202
|
+
| **`unstable_noStore()`** | Server | `https://nextjs.org/docs/app/api-reference/functions/unstable_noStore.md` | Opts out of caching declaratively inside data-fetching functions. |
|
|
203
|
+
| **`unstable_rethrow(err)`** | Server | `https://nextjs.org/docs/app/api-reference/functions/unstable_rethrow.md` | Re-throws internal Next.js control-flow errors (redirects, notFound) in catch blocks. |
|
|
204
|
+
| **`ImageResponse`** | Server / Edge | `https://nextjs.org/docs/app/api-reference/functions/image-response.md` | Generates dynamic PNG social images from JSX and CSS styles using Satori. |
|
|
205
|
+
| **`NextRequest`** | Server / Middleware | `https://nextjs.org/docs/app/api-reference/functions/next-request.md` | Extended Web Standard Request object with cookies, nextUrl, and geo ip helpers. |
|
|
206
|
+
| **`NextResponse`** | Server / Middleware | `https://nextjs.org/docs/app/api-reference/functions/next-response.md` | Extended Web Standard Response object for headers, cookies, redirects, and rewrites. |
|
|
207
|
+
| **`useRouter()`** | Client | `https://nextjs.org/docs/app/api-reference/functions/use-router.md` | Programmatic client-side navigation (`push`, `replace`, `refresh`, `back`, `forward`). |
|
|
208
|
+
| **`usePathname()`** | Client | `https://nextjs.org/docs/app/api-reference/functions/use-pathname.md` | Reads current URL pathname string without search parameters. |
|
|
209
|
+
| **`useSearchParams()`** | Client | `https://nextjs.org/docs/app/api-reference/functions/use-search-params.md` | Read-only access to URL query parameters (`URLSearchParams`). |
|
|
210
|
+
| **`useParams()`** | Client | `https://nextjs.org/docs/app/api-reference/functions/use-params.md` | Accesses dynamic route segment parameters filled by current route. |
|
|
211
|
+
| **`useSelectedLayoutSegment()`** | Client | `https://nextjs.org/docs/app/api-reference/functions/use-selected-layout-segment.md` | Reads active child route segment one level below calling layout. |
|
|
212
|
+
| **`useSelectedLayoutSegments()`** | Client | `https://nextjs.org/docs/app/api-reference/functions/use-selected-layout-segments.md` | Reads array of all active nested child segments below calling layout. |
|
|
213
|
+
| **`useReportWebVitals(fn)`** | Client | `https://nextjs.org/docs/app/api-reference/functions/use-report-web-vitals.md` | Custom hook to report metrics (FCP, LCP, CLS, FID, TTFB, INP) to analytics. |
|
|
214
|
+
| **`useServerInsertedHTML(cb)`** | Client | `https://nextjs.org/docs/app/api-reference/functions/use-server-inserted-html.md` | Inserts critical CSS or tags directly into the server HTML stream before hydration. |
|
|
215
|
+
| **`useLinkStatus(href)`** | Client | `https://nextjs.org/docs/app/api-reference/functions/use-link-status.md` | Inspects prefetching and navigation status of a target route link. |
|
|
216
|
+
| **`useOffline()`** | Client | `https://nextjs.org/docs/app/api-reference/functions/use-offline.md` | React hook to detect online/offline network transitions and retry requests. |
|
|
217
|
+
| **`userAgent(request)`** | Server / Middleware | `https://nextjs.org/docs/app/api-reference/functions/userAgent.md` | Helper to parse user agent strings into browser, device, OS, and bot metadata. |
|
|
218
|
+
|
|
219
|
+
---
|
|
220
|
+
|
|
221
|
+
## 6. Key `next.config.js` Production Directives
|
|
222
|
+
|
|
223
|
+
| Property | Raw Markdown URL | Description |
|
|
224
|
+
|---|---|---|
|
|
225
|
+
| `output: 'standalone'` | `https://nextjs.org/docs/app/api-reference/config/next-config-js/output.md` | Automatically traces file dependencies to produce minimal Docker container deployments. |
|
|
226
|
+
| `cacheComponents` | `https://nextjs.org/docs/app/api-reference/config/next-config-js/cacheComponents.md` | Enables `"use cache"` and `cacheLife` modern caching runtime. |
|
|
227
|
+
| `cacheHandlers` | `https://nextjs.org/docs/app/api-reference/config/next-config-js/cacheHandlers.md` | Connects distributed remote cache providers (Redis, Memcached, KV). |
|
|
228
|
+
| `experimental.taint` | `https://nextjs.org/docs/app/api-reference/config/next-config-js/taint.md` | Enables React Taint API protection against credential leakage to client bundles. |
|
|
229
|
+
| `experimental.reactCompiler` | `https://nextjs.org/docs/app/api-reference/config/next-config-js/reactCompiler.md` | Enables automated memoization without manual `useMemo` or `useCallback`. |
|
|
230
|
+
| `turbopack` | `https://nextjs.org/docs/app/api-reference/config/next-config-js/turbopack.md` | Configures Turbopack build flags, loader rules, and module aliases. |
|
|
231
|
+
| `turbopackFileSystemCache` | `https://nextjs.org/docs/app/api-reference/config/next-config-js/turbopackFileSystemCache.md` | Enables persistent disk-level Turbopack caching for fast cold starts. |
|
|
232
|
+
| `logging` | `https://nextjs.org/docs/app/api-reference/config/next-config-js/logging.md` | Terminal fetch logging (`fullUrl: true`), incoming requests, and client console forwarding. |
|
|
233
|
+
| `serverExternalPackages` | `https://nextjs.org/docs/app/api-reference/config/next-config-js/serverExternalPackages.md` | Excludes heavy server libraries (`sharp`, `pg`, `@prisma/client`) from bundling. |
|
|
234
|
+
| `images.remotePatterns` | `https://nextjs.org/docs/app/api-reference/config/next-config-js/images.md` | Whitelist approved remote hosts and protocols for image optimization. |
|
|
235
|
+
| `typedRoutes` | `https://nextjs.org/docs/app/api-reference/config/next-config-js/typedRoutes.md` | Enforces statically typed route strings in `<Link href="...">`. |
|
|
236
|
+
| `headers` & `rewrites` | `https://nextjs.org/docs/app/api-reference/config/next-config-js/headers.md` | Configures HTTP security headers and path-rewriting rules. |
|
|
237
|
+
|
|
238
|
+
---
|
|
239
|
+
|
|
240
|
+
## 7. CLI & Adapters Architecture
|
|
241
|
+
|
|
242
|
+
### A. CLI Commands
|
|
243
|
+
- `https://nextjs.org/docs/app/api-reference/cli/create-next-app.md`: Fast project scaffolding.
|
|
244
|
+
- `https://nextjs.org/docs/app/api-reference/cli/next.md`:
|
|
245
|
+
- `next dev --turbopack`: Starts local development with Turbopack.
|
|
246
|
+
- `next build`: Generates production bundles and runs static optimization.
|
|
247
|
+
- `next start`: Starts production Node.js server.
|
|
248
|
+
- `next info`: Prints environment, Node, and platform diagnostic information.
|
|
249
|
+
|
|
250
|
+
### B. Deployment Adapters (`@next/routing`)
|
|
251
|
+
- Adapter specification: `https://nextjs.org/docs/app/api-reference/adapters.md`
|
|
252
|
+
- Adapter creation: `https://nextjs.org/docs/app/api-reference/adapters/creating-an-adapter.md`
|
|
253
|
+
- Routing matching: `https://nextjs.org/docs/app/api-reference/adapters/routing-with-next-routing.md`
|
|
254
|
+
- Implementing PPR in custom adapters: `https://nextjs.org/docs/app/api-reference/adapters/implementing-ppr-in-an-adapter.md`
|
|
255
|
+
- Supporting immutable static assets: `https://nextjs.org/docs/app/api-reference/adapters/immutable-static-assets.md`
|
|
256
|
+
|
|
257
|
+
---
|
|
258
|
+
|
|
259
|
+
## 8. Quick Task-to-Feature Decision Matrix
|
|
260
|
+
|
|
261
|
+
When faced with an implementation task, consult this direct lookup table:
|
|
262
|
+
|
|
263
|
+
| If you need to... | Use this Next.js Feature | Direct URL |
|
|
264
|
+
|---|---|---|
|
|
265
|
+
| Secure DB queries from leaking to client | **Data Access Layer (DAL)** + `server-only` | `https://nextjs.org/docs/app/guides/data-security.md` |
|
|
266
|
+
| Block tokens/passwords from RSC client props | **React Taint API** (`taintObjectReference`) | `https://nextjs.org/docs/app/api-reference/config/next-config-js/taint.md` |
|
|
267
|
+
| Cache an expensive calculation or third-party API | **`"use cache"`** + **`cacheLife`** | `https://nextjs.org/docs/app/api-reference/directives/use-cache.md` |
|
|
268
|
+
| Invalidate cached entries on mutation | **`revalidateTag()`** / **`revalidatePath()`** | `https://nextjs.org/docs/app/api-reference/functions/revalidateTag.md` |
|
|
269
|
+
| Implement zero-shift hero images | **`<Image priority={true}>`** | `https://nextjs.org/docs/app/api-reference/components/image.md` |
|
|
270
|
+
| Avoid layout shift with custom web fonts | **`next/font/google`** or **`next/font/local`** | `https://nextjs.org/docs/app/api-reference/components/font.md` |
|
|
271
|
+
| Build modal screens with custom shareable URLs | **Intercepting Routes** (`(..)photo`) | `https://nextjs.org/docs/app/api-reference/file-conventions/intercepting-routes.md` |
|
|
272
|
+
| Isolate layout sections with independent loading | **Parallel Routes** (`@slot`) | `https://nextjs.org/docs/app/api-reference/file-conventions/parallel-routes.md` |
|
|
273
|
+
| Catch Segment Crashes with Recovery | **`error.tsx`** (`reset()`) | `https://nextjs.org/docs/app/api-reference/file-conventions/error.md` |
|
|
274
|
+
| Generate Dynamic Social Card PNGs | **`ImageResponse`** | `https://nextjs.org/docs/app/api-reference/functions/image-response.md` |
|
|
275
|
+
| Run background work after HTTP response finishes | **`after(async () => { ... })`** | `https://nextjs.org/docs/app/api-reference/functions/after.md` |
|
|
276
|
+
| Containerize for Kubernetes / Docker | **`output: 'standalone'`** in `next.config` | `https://nextjs.org/docs/app/guides/self-hosting.md` |
|
|
@@ -0,0 +1,49 @@
|
|
|
1
|
+
# Next.js Full Production Audit Checklist
|
|
2
|
+
|
|
3
|
+
An exhaustive checklist reflecting the official Next.js guidelines across the application lifecycle.
|
|
4
|
+
|
|
5
|
+
## Phase 1: During Development
|
|
6
|
+
- [ ] **Routing**:
|
|
7
|
+
- [ ] Use `layout.tsx` for persistent shell UI and shared state.
|
|
8
|
+
- [ ] Use `<Link>` with `prefetch` for fast page transitions.
|
|
9
|
+
- [ ] **Media & Assets**:
|
|
10
|
+
- [ ] `next/image` used with explicit dimensions to prevent CLS.
|
|
11
|
+
- [ ] Critical above-the-fold hero image marked with `priority`.
|
|
12
|
+
- [ ] `next/font` used with `display: 'swap'` for zero font layout shift.
|
|
13
|
+
- [ ] Third-party scripts loaded via `next/script` with appropriate strategies (`afterInteractive`, `lazyOnload`).
|
|
14
|
+
- [ ] **Data Fetching**:
|
|
15
|
+
- [ ] Request waterfalls eliminated using `Promise.all` or parallel Server Components.
|
|
16
|
+
- [ ] Server actions encapsulated with authentication and schema validation (Zod).
|
|
17
|
+
|
|
18
|
+
---
|
|
19
|
+
|
|
20
|
+
## Phase 2: Security & Privacy
|
|
21
|
+
- [ ] **Module Boundaries**:
|
|
22
|
+
- [ ] `import "server-only"` added to all database, ORM, and secret handling files.
|
|
23
|
+
- [ ] Taint API (`experimental_taintUniqueValue`) applied to sensitive user fields (tokens, hashes).
|
|
24
|
+
- [ ] **Environment Variables**:
|
|
25
|
+
- [ ] Audit `.env.local` to verify only public values carry the `NEXT_PUBLIC_` prefix.
|
|
26
|
+
- [ ] `.env*` files excluded from Git tracking in `.gitignore`.
|
|
27
|
+
- [ ] **Security Headers & CSP**:
|
|
28
|
+
- [ ] Strict Content Security Policy (CSP) with cryptographic nonces configured in `middleware.ts`.
|
|
29
|
+
- [ ] Strict-Transport-Security (HSTS), X-Content-Type-Options, X-Frame-Options configured.
|
|
30
|
+
|
|
31
|
+
---
|
|
32
|
+
|
|
33
|
+
## Phase 3: Error Handling & Observability
|
|
34
|
+
- [ ] **Error Boundaries**:
|
|
35
|
+
- [ ] `app/error.tsx` implemented with retry controls.
|
|
36
|
+
- [ ] `app/global-error.tsx` configured to wrap `<html>` and `<body>`.
|
|
37
|
+
- [ ] `app/not-found.tsx` styled to match brand design.
|
|
38
|
+
- [ ] **Observability**:
|
|
39
|
+
- [ ] OpenTelemetry instrumentation configured via `instrumentation.ts`.
|
|
40
|
+
- [ ] Real-user monitoring (RUM) configured for Core Web Vitals (LCP, INP, CLS).
|
|
41
|
+
|
|
42
|
+
---
|
|
43
|
+
|
|
44
|
+
## Phase 4: Build & Deployment
|
|
45
|
+
- [ ] **Build Verification**:
|
|
46
|
+
- [ ] Successful local build: `npm run build`.
|
|
47
|
+
- [ ] Local production run verified: `npm run start`.
|
|
48
|
+
- [ ] `output: 'standalone'` configured if deploying to Docker or Kubernetes.
|
|
49
|
+
- [ ] Bundle analyzer inspected via `@next/bundle-analyzer` to eliminate bloat packages.
|
|
@@ -0,0 +1,44 @@
|
|
|
1
|
+
# Content Security Policy (CSP) & Security Headers in Next.js
|
|
2
|
+
|
|
3
|
+
## Strict CSP Nonce Middleware (`middleware.ts`)
|
|
4
|
+
|
|
5
|
+
```typescript
|
|
6
|
+
import { NextRequest, NextResponse } from "next/server";
|
|
7
|
+
|
|
8
|
+
export function middleware(request: NextRequest) {
|
|
9
|
+
const nonce = Buffer.from(crypto.randomUUID()).toString("base64");
|
|
10
|
+
const isDev = process.env.NODE_ENV === "development";
|
|
11
|
+
|
|
12
|
+
const cspHeader = `
|
|
13
|
+
default-src 'self';
|
|
14
|
+
script-src 'self' 'nonce-${nonce}' 'strict-dynamic' ${isDev ? "'unsafe-eval'" : ""};
|
|
15
|
+
style-src 'self' 'nonce-${nonce}';
|
|
16
|
+
img-src 'self' blob: data: https:;
|
|
17
|
+
font-src 'self';
|
|
18
|
+
object-src 'none';
|
|
19
|
+
base-uri 'self';
|
|
20
|
+
form-action 'self';
|
|
21
|
+
frame-ancestors 'none';
|
|
22
|
+
upgrade-insecure-requests;
|
|
23
|
+
`.replace(/\s{2,}/g, " ").trim();
|
|
24
|
+
|
|
25
|
+
const requestHeaders = new Headers(request.headers);
|
|
26
|
+
requestHeaders.set("x-nonce", nonce);
|
|
27
|
+
requestHeaders.set("Content-Security-Policy", cspHeader);
|
|
28
|
+
|
|
29
|
+
const response = NextResponse.next({
|
|
30
|
+
request: { headers: requestHeaders },
|
|
31
|
+
});
|
|
32
|
+
|
|
33
|
+
response.headers.set("Content-Security-Policy", cspHeader);
|
|
34
|
+
response.headers.set("X-Frame-Options", "DENY");
|
|
35
|
+
response.headers.set("X-Content-Type-Options", "nosniff");
|
|
36
|
+
response.headers.set("Referrer-Policy", "strict-origin-when-cross-origin");
|
|
37
|
+
response.headers.set(
|
|
38
|
+
"Permissions-Policy",
|
|
39
|
+
"camera=(), microphone=(), geolocation=()"
|
|
40
|
+
);
|
|
41
|
+
|
|
42
|
+
return response;
|
|
43
|
+
}
|
|
44
|
+
```
|
|
@@ -0,0 +1,85 @@
|
|
|
1
|
+
#!/usr/bin/env python3
|
|
2
|
+
"""
|
|
3
|
+
auditProductionReadiness.py
|
|
4
|
+
Automated auditor that scans a Next.js App Router project for production checklist compliance.
|
|
5
|
+
"""
|
|
6
|
+
|
|
7
|
+
import os
|
|
8
|
+
import re
|
|
9
|
+
import sys
|
|
10
|
+
|
|
11
|
+
def audit_project(root_dir: str):
|
|
12
|
+
issues = []
|
|
13
|
+
passes = []
|
|
14
|
+
|
|
15
|
+
# 1. Check .gitignore for .env
|
|
16
|
+
gitignore_path = os.path.join(root_dir, ".gitignore")
|
|
17
|
+
if os.path.exists(gitignore_path):
|
|
18
|
+
with open(gitignore_path, "r", encoding="utf-8") as f:
|
|
19
|
+
content = f.read()
|
|
20
|
+
if ".env" in content:
|
|
21
|
+
passes.append(".gitignore correctly excludes .env files")
|
|
22
|
+
else:
|
|
23
|
+
issues.append("Security: .gitignore is missing .env exclusion rules")
|
|
24
|
+
else:
|
|
25
|
+
issues.append("Security: Missing root .gitignore")
|
|
26
|
+
|
|
27
|
+
# 2. Check next.config for standalone output
|
|
28
|
+
config_found = False
|
|
29
|
+
for conf_name in ["next.config.ts", "next.config.js", "next.config.mjs"]:
|
|
30
|
+
conf_path = os.path.join(root_dir, conf_name)
|
|
31
|
+
if os.path.exists(conf_path):
|
|
32
|
+
config_found = True
|
|
33
|
+
with open(conf_path, "r", encoding="utf-8") as f:
|
|
34
|
+
c = f.read()
|
|
35
|
+
if "output" in c and "standalone" in c:
|
|
36
|
+
passes.append("Docker: output: 'standalone' detected in next.config")
|
|
37
|
+
else:
|
|
38
|
+
issues.append("Deployment: next.config is missing output: 'standalone' (recommended for containerization)")
|
|
39
|
+
break
|
|
40
|
+
|
|
41
|
+
# 3. Check for global-error.tsx in app
|
|
42
|
+
app_dir = os.path.join(root_dir, "app")
|
|
43
|
+
if not os.path.exists(app_dir):
|
|
44
|
+
app_dir = os.path.join(root_dir, "src", "app")
|
|
45
|
+
|
|
46
|
+
if os.path.exists(app_dir):
|
|
47
|
+
files = os.listdir(app_dir)
|
|
48
|
+
if any("global-error" in f for f in files):
|
|
49
|
+
passes.append("Resilience: global-error.tsx found in root app directory")
|
|
50
|
+
else:
|
|
51
|
+
issues.append("Resilience: Missing app/global-error.tsx for root layout error boundaries")
|
|
52
|
+
|
|
53
|
+
# 4. Check for database leakage in "use client" files
|
|
54
|
+
forbidden_db_patterns = [r"from ['\"]@prisma", r"from ['\"]drizzle-orm", r"from ['\"]pg['\"]"]
|
|
55
|
+
for current_root, _, current_files in os.walk(root_dir):
|
|
56
|
+
if "node_modules" in current_root or ".next" in current_root:
|
|
57
|
+
continue
|
|
58
|
+
for file in current_files:
|
|
59
|
+
if file.endswith((".tsx", ".jsx", ".ts", ".js")):
|
|
60
|
+
fp = os.path.join(current_root, file)
|
|
61
|
+
try:
|
|
62
|
+
with open(fp, "r", encoding="utf-8", errors="ignore") as f:
|
|
63
|
+
text = f.read()
|
|
64
|
+
if '"use client"' in text or "'use client'" in text:
|
|
65
|
+
for pat in forbidden_db_patterns:
|
|
66
|
+
if re.search(pat, text):
|
|
67
|
+
issues.append(f"Security Leak: Database import found inside Client Component: {fp}")
|
|
68
|
+
except Exception:
|
|
69
|
+
pass
|
|
70
|
+
|
|
71
|
+
print("=== Next.js Production Readiness Audit ===")
|
|
72
|
+
print(f"\n Passed Checks ({len(passes)}):")
|
|
73
|
+
for p in passes:
|
|
74
|
+
print(f" • {p}")
|
|
75
|
+
|
|
76
|
+
if issues:
|
|
77
|
+
print(f"\n Action Items & Warnings ({len(issues)}):")
|
|
78
|
+
for i in issues:
|
|
79
|
+
print(f" ▲ {i}")
|
|
80
|
+
else:
|
|
81
|
+
print("\n Excellent: No production checklist violations found!")
|
|
82
|
+
|
|
83
|
+
if __name__ == "__main__":
|
|
84
|
+
target = sys.argv[1] if len(sys.argv) > 1 else "."
|
|
85
|
+
audit_project(target)
|
|
@@ -0,0 +1,102 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: shadcn-ui
|
|
3
|
+
description: High-density guide and automation for shadcn/ui v4. Supports adding atomic primitives, composite blocks, direct component MDX retrieval, and CVA composition. Use when building, styling, or scaffolding UI with React, Next.js, and Tailwind CSS.
|
|
4
|
+
version: v4
|
|
5
|
+
last-verified: 2026-11-17
|
|
6
|
+
compatibility: React 18+, Next.js 14/15/16, Tailwind CSS v3/v4, Vite
|
|
7
|
+
slash-commands:
|
|
8
|
+
- command: /shadcn-add
|
|
9
|
+
description: Add atomic primitives or composite UI blocks via CLI
|
|
10
|
+
argument-hint: "<component|block-name> [--yes] [--overwrite]"
|
|
11
|
+
- command: /shadcn-ai
|
|
12
|
+
description: Scaffold agentic AI components (chat, reasoning, tool-call, prompt-input)
|
|
13
|
+
argument-hint: "<@ai-elements/name>"
|
|
14
|
+
- command: /shadcn-theme
|
|
15
|
+
description: Configure CSS variables, design tokens, and dark mode
|
|
16
|
+
argument-hint: "[--base-color=neutral|slate|zinc] [--css-vars]"
|
|
17
|
+
- command: /shadcn-diff
|
|
18
|
+
description: Inspect differences against upstream component registries
|
|
19
|
+
argument-hint: "[<component>]"
|
|
20
|
+
---
|
|
21
|
+
|
|
22
|
+
# shadcn/ui Engineering Guide
|
|
23
|
+
|
|
24
|
+
## 1. Core Architecture & Philosophy
|
|
25
|
+
- **Code Ownership**: Components live inside your repository (`components/ui/`). Never treat them as locked node_modules.
|
|
26
|
+
- **Atomic Composition**: Built on accessible headless primitives (Radix UI, Base UI, React Aria), styled using Tailwind CSS, and variant-composed with `cva` (Class Variance Authority).
|
|
27
|
+
- **Utility Standard**: Always use `cn(...)` (`clsx` + `tailwind-merge`) to resolve className conflicts.
|
|
28
|
+
|
|
29
|
+
---
|
|
30
|
+
|
|
31
|
+
## 2. CLI Command Matrix (CLI v4)
|
|
32
|
+
|
|
33
|
+
Run via your package runner (`npx shadcn@latest`, `pnpm dlx shadcn@latest`, `bunx --bun shadcn@latest`):
|
|
34
|
+
|
|
35
|
+
| Action | Command | Key Flags |
|
|
36
|
+
| :--- | :--- | :--- |
|
|
37
|
+
| **Initialize** | `npx shadcn@latest init` | `-t, --template <next\|vite>`<br>`-b, --base <radix\|base\|aria>`<br>`-d, --defaults`, `-y, --yes` |
|
|
38
|
+
| **Add Primitive** | `npx shadcn@latest add <name>` | `-y` (skip prompts), `-o` (overwrite), `--dry-run`, `--diff` |
|
|
39
|
+
| **Add Composite Block** | `npx shadcn@latest add <block-name>` | e.g. `dashboard-01`, `login-01`, `sidebar-01` |
|
|
40
|
+
| **Add AI Components** | `npx shadcn@latest add @ai-elements/<component>` | e.g. `prompt-input`, `reasoning`, `tool-call`, `conversation` |
|
|
41
|
+
| **Add Remote Block / Registry** | `npx shadcn@latest add "<url-or-spec>"` | e.g. `https://www.shadcn-ui-blocks.com/r/hero-01.json`<br>`@namespace/block-name` |
|
|
42
|
+
| **Fetch Terminal Docs / MD** | `npx shadcn@latest docs <component>` | Fetches live MD documentation directly into stdout |
|
|
43
|
+
| **Diagnose Environment** | `npx shadcn@latest info` | Inspects Tailwind variables, framework, and installed components |
|
|
44
|
+
|
|
45
|
+
---
|
|
46
|
+
|
|
47
|
+
## 3. Direct Component MD / MDX Target Integration
|
|
48
|
+
Rather than guessing or reading generic websites, fetch component `.mdx` files directly:
|
|
49
|
+
|
|
50
|
+
1. **CLI Native**:
|
|
51
|
+
```bash
|
|
52
|
+
npx shadcn@latest docs button
|
|
53
|
+
```
|
|
54
|
+
2. **Deterministic Script Fetcher**:
|
|
55
|
+
Use the bundled [scripts/fetchComponentDocs.py](scripts/fetchComponentDocs.py) to pull raw `.mdx` directly from the official shadcn repository:
|
|
56
|
+
```bash
|
|
57
|
+
python3 skills/frontend/shadcn-ui/scripts/fetchComponentDocs.py --component dialog
|
|
58
|
+
```
|
|
59
|
+
3. See [references/componentMarkdownSources.md](references/componentMarkdownSources.md) for the direct raw GitHub MDX endpoints.
|
|
60
|
+
|
|
61
|
+
---
|
|
62
|
+
|
|
63
|
+
## 4. shadcn AI Components & Agentic UI
|
|
64
|
+
For LLM chat interfaces, agent reasoning, and generative UI:
|
|
65
|
+
- **Core Primitives**: `conversation`, `message`, `prompt-input`, `reasoning`, `tool-call`, `sources`, and `code-block`.
|
|
66
|
+
- **Install Syntax**:
|
|
67
|
+
```bash
|
|
68
|
+
# Chat layout
|
|
69
|
+
npx shadcn@latest add @ai-elements/conversation @ai-elements/prompt-input -y
|
|
70
|
+
# Agent thought & tool inspection cards
|
|
71
|
+
npx shadcn@latest add @ai-elements/reasoning @ai-elements/tool-call -y
|
|
72
|
+
```
|
|
73
|
+
- **Custom Registry Config**: Configure `@ai-elements` or `@assistant-ui` in `components.json`. See [references/aiComponentsCatalog.md](references/aiComponentsCatalog.md) for complete details.
|
|
74
|
+
|
|
75
|
+
---
|
|
76
|
+
|
|
77
|
+
## 5. Blocks & Layout Workflow
|
|
78
|
+
When building complex screens:
|
|
79
|
+
1. Check available blocks or templates (dashboards, forms, navbars).
|
|
80
|
+
2. Install via block command:
|
|
81
|
+
```bash
|
|
82
|
+
npx shadcn@latest add dashboard-01 -y
|
|
83
|
+
```
|
|
84
|
+
3. Customize exported components directly inside `components/blocks/` or `app/`.
|
|
85
|
+
|
|
86
|
+
---
|
|
87
|
+
|
|
88
|
+
## 5. Anti-Patterns & Pitfalls
|
|
89
|
+
- ❌ **Wrapper Antipath**: Do not create redundant abstraction wrappers around shadcn primitives unless extending global design tokens.
|
|
90
|
+
- ❌ **Inline Style Overrides**: Do not use `style={{...}}`; use Tailwind utility classes via `className={cn("...", className)}`.
|
|
91
|
+
- ❌ **Hardcoded Hex Values**: Always use semantic design tokens (`bg-background`, `text-foreground`, `text-muted-foreground`, `border-border`).
|
|
92
|
+
- ❌ **Blind Overwrite**: Use `--diff` or `--dry-run` when updating existing primitives to avoid wiping customizations.
|
|
93
|
+
|
|
94
|
+
---
|
|
95
|
+
|
|
96
|
+
## 6. References & Bundled Tools
|
|
97
|
+
- **Complete shadcn/ui Offline Docs Library**: [assets/](assets/) — Exhaustive offline markdown docs covering 69 UI primitives, 22 AI elements, theming, CLI, forms, dark mode, and registry specifications.
|
|
98
|
+
- Detailed command flags: [references/cliCommands.md](references/cliCommands.md)
|
|
99
|
+
- AI components catalog: [references/aiComponentsCatalog.md](references/aiComponentsCatalog.md)
|
|
100
|
+
- Block registries & sources: [references/blocksCatalog.md](references/blocksCatalog.md)
|
|
101
|
+
- Raw MDX component source links: [references/componentMarkdownSources.md](references/componentMarkdownSources.md)
|
|
102
|
+
- CLI doc retrieval tool: [scripts/fetchComponentDocs.py](scripts/fetchComponentDocs.py)
|