npm - @ngxtm/devkit - Versions diffs - 3.4.0 → 3.4.1 - Mend

@ngxtm/devkit 3.4.0 → 3.4.1

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.

Files changed (343) hide show

package/package.json +2 -1
package/rules/README.md +141 -0
package/rules/dart/best-practices/SKILL.md +23 -0
package/rules/dart/language/SKILL.md +52 -0
package/rules/dart/tooling/SKILL.md +43 -0
package/rules/dotnet/aspnet-core/SKILL.md +92 -0
package/rules/dotnet/aspnet-core/references/REFERENCE.md +335 -0
package/rules/dotnet/best-practices/SKILL.md +101 -0
package/rules/dotnet/best-practices/references/REFERENCE.md +256 -0
package/rules/dotnet/blazor/SKILL.md +146 -0
package/rules/dotnet/blazor/references/REFERENCE.md +392 -0
package/rules/dotnet/language/SKILL.md +82 -0
package/rules/dotnet/language/references/REFERENCE.md +222 -0
package/rules/dotnet/patterns.rule.md +388 -0
package/rules/dotnet/razor-pages/SKILL.md +124 -0
package/rules/dotnet/razor-pages/references/REFERENCE.md +321 -0
package/rules/dotnet/security/SKILL.md +89 -0
package/rules/dotnet/security/references/REFERENCE.md +295 -0
package/rules/dotnet/tooling/SKILL.md +92 -0
package/rules/dotnet/tooling/references/REFERENCE.md +300 -0
package/rules/flutter/auto-route-navigation/SKILL.md +43 -0
package/rules/flutter/auto-route-navigation/references/REFERENCE.md +19 -0
package/rules/flutter/auto-route-navigation/references/router-config.md +62 -0
package/rules/flutter/bloc-state-management/SKILL.md +64 -0
package/rules/flutter/bloc-state-management/references/REFERENCE.md +20 -0
package/rules/flutter/bloc-state-management/references/auth-bloc-example.md +52 -0
package/rules/flutter/bloc-state-management/references/equatable-usage.md +56 -0
package/rules/flutter/bloc-state-management/references/property-based-state.md +68 -0
package/rules/flutter/bloc.rule.md +76 -0
package/rules/flutter/cicd/SKILL.md +48 -0
package/rules/flutter/cicd/references/advanced-workflow.md +66 -0
package/rules/flutter/cicd/references/fastlane.md +139 -0
package/rules/flutter/cicd/references/github-actions.md +59 -0
package/rules/flutter/dependency-injection/SKILL.md +42 -0
package/rules/flutter/dependency-injection/references/REFERENCE.md +15 -0
package/rules/flutter/dependency-injection/references/modules.md +37 -0
package/rules/flutter/error-handling/SKILL.md +32 -0
package/rules/flutter/error-handling/references/REFERENCE.md +19 -0
package/rules/flutter/error-handling/references/error-mapping.md +31 -0
package/rules/flutter/feature-based-clean-architecture/SKILL.md +46 -0
package/rules/flutter/feature-based-clean-architecture/references/REFERENCE.md +14 -0
package/rules/flutter/feature-based-clean-architecture/references/folder-structure.md +36 -0
package/rules/flutter/getx-navigation/SKILL.md +70 -0
package/rules/flutter/getx-navigation/references/app-pages.md +40 -0
package/rules/flutter/getx-navigation/references/middleware-example.md +29 -0
package/rules/flutter/getx-state-management/SKILL.md +76 -0
package/rules/flutter/getx-state-management/references/binding-example.md +32 -0
package/rules/flutter/getx-state-management/references/reactive-vs-simple.md +39 -0
package/rules/flutter/go-router-navigation/SKILL.md +57 -0
package/rules/flutter/idiomatic-flutter/SKILL.md +20 -0
package/rules/flutter/layer-based-clean-architecture/SKILL.md +50 -0
package/rules/flutter/layer-based-clean-architecture/references/REFERENCE.md +60 -0
package/rules/flutter/layer-based-clean-architecture/references/repository-mapping.md +50 -0
package/rules/flutter/localization/SKILL.md +50 -0
package/rules/flutter/localization/references/REFERENCE.md +48 -0
package/rules/flutter/localization/references/sheet-loader.md +33 -0
package/rules/flutter/navigator-v1-navigation/SKILL.md +71 -0
package/rules/flutter/navigator-v1-navigation/references/on-generate-route.md +48 -0
package/rules/flutter/performance/SKILL.md +24 -0
package/rules/flutter/retrofit-networking/SKILL.md +51 -0
package/rules/flutter/retrofit-networking/references/REFERENCE.md +19 -0
package/rules/flutter/retrofit-networking/references/token-refresh.md +40 -0
package/rules/flutter/riverpod-state-management/SKILL.md +53 -0
package/rules/flutter/riverpod-state-management/references/architecture.md +124 -0
package/rules/flutter/riverpod-state-management/references/best-practices.md +89 -0
package/rules/flutter/riverpod-state-management/references/testing.md +73 -0
package/rules/flutter/riverpod.rule.md +78 -0
package/rules/flutter/security/SKILL.md +33 -0
package/rules/flutter/security/references/REFERENCE.md +15 -0
package/rules/flutter/security/references/network-security.md +28 -0
package/rules/flutter/testing/SKILL.md +44 -0
package/rules/flutter/testing/references/REFERENCE.md +21 -0
package/rules/flutter/testing/references/bloc-testing.md +38 -0
package/rules/flutter/testing/references/integration-testing.md +128 -0
package/rules/flutter/testing/references/robot-pattern.md +82 -0
package/rules/flutter/testing/references/unit-testing.md +130 -0
package/rules/flutter/testing/references/widget-testing.md +120 -0
package/rules/flutter/widgets/SKILL.md +37 -0
package/rules/golang/chi-router/SKILL.md +219 -0
package/rules/golang/chi-router/references/REFERENCE.md +13 -0
package/rules/golang/chi-router/references/routing-patterns.md +205 -0
package/rules/golang/cobra-cli/SKILL.md +227 -0
package/rules/golang/cobra-cli/references/REFERENCE.md +13 -0
package/rules/golang/cobra-cli/references/command-patterns.md +224 -0
package/rules/golang/core/SKILL.md +210 -0
package/rules/golang/core/references/REFERENCE.md +14 -0
package/rules/golang/core/references/concurrency-patterns.md +114 -0
package/rules/golang/core/references/error-handling.md +87 -0
package/rules/golang/echo-framework/SKILL.md +215 -0
package/rules/golang/echo-framework/references/REFERENCE.md +14 -0
package/rules/golang/echo-framework/references/middleware-patterns.md +141 -0
package/rules/golang/echo-framework/references/routing-patterns.md +140 -0
package/rules/golang/ent-orm/SKILL.md +239 -0
package/rules/golang/ent-orm/references/REFERENCE.md +13 -0
package/rules/golang/ent-orm/references/schema-patterns.md +255 -0
package/rules/golang/fiber-framework/SKILL.md +196 -0
package/rules/golang/fiber-framework/references/REFERENCE.md +13 -0
package/rules/golang/fiber-framework/references/routing-patterns.md +191 -0
package/rules/golang/gin-framework/SKILL.md +205 -0
package/rules/golang/gin-framework/references/REFERENCE.md +14 -0
package/rules/golang/gin-framework/references/middleware-patterns.md +119 -0
package/rules/golang/gorm-orm/SKILL.md +196 -0
package/rules/golang/gorm-orm/references/REFERENCE.md +14 -0
package/rules/golang/gorm-orm/references/model-definitions.md +167 -0
package/rules/golang/gorm-orm/references/query-patterns.md +161 -0
package/rules/golang/grpc/SKILL.md +231 -0
package/rules/golang/grpc/references/REFERENCE.md +13 -0
package/rules/golang/grpc/references/service-patterns.md +276 -0
package/rules/golang/testify/SKILL.md +239 -0
package/rules/golang/testify/references/REFERENCE.md +13 -0
package/rules/golang/testify/references/assert-patterns.md +170 -0
package/rules/golang/validator/SKILL.md +234 -0
package/rules/golang/validator/references/REFERENCE.md +13 -0
package/rules/golang/validator/references/validation-tags.md +211 -0
package/rules/golang/viper-config/SKILL.md +244 -0
package/rules/golang/viper-config/references/REFERENCE.md +13 -0
package/rules/golang/viper-config/references/config-loading.md +181 -0
package/rules/golang/wire-di/SKILL.md +243 -0
package/rules/golang/wire-di/references/REFERENCE.md +13 -0
package/rules/golang/wire-di/references/provider-patterns.md +193 -0
package/rules/golang/zap-logging/SKILL.md +203 -0
package/rules/golang/zap-logging/references/REFERENCE.md +13 -0
package/rules/golang/zap-logging/references/logger-config.md +165 -0
package/rules/java/build-gradle/SKILL.md +92 -0
package/rules/java/build-gradle/references/REFERENCE.md +14 -0
package/rules/java/build-gradle/references/kotlin-dsl.md +118 -0
package/rules/java/build-gradle/references/task-configuration.md +132 -0
package/rules/java/build-maven/SKILL.md +86 -0
package/rules/java/build-maven/references/REFERENCE.md +14 -0
package/rules/java/build-maven/references/dependency-management.md +111 -0
package/rules/java/build-maven/references/lifecycle-phases.md +114 -0
package/rules/java/graalvm-native/SKILL.md +105 -0
package/rules/java/graalvm-native/references/REFERENCE.md +12 -0
package/rules/java/java-collections-streams/SKILL.md +148 -0
package/rules/java/java-collections-streams/references/REFERENCE.md +15 -0
package/rules/java/java-collections-streams/references/collectors-patterns.md +178 -0
package/rules/java/java-collections-streams/references/stream-pipelines.md +165 -0
package/rules/java/java-concurrency/SKILL.md +187 -0
package/rules/java/java-concurrency/references/REFERENCE.md +17 -0
package/rules/java/java-concurrency/references/completable-future.md +165 -0
package/rules/java/java-concurrency/references/executor-patterns.md +176 -0
package/rules/java/java-concurrency/references/virtual-threads.md +190 -0
package/rules/java/java-core-language/SKILL.md +121 -0
package/rules/java/java-core-language/references/REFERENCE.md +15 -0
package/rules/java/java-core-language/references/jvm-memory-model.md +160 -0
package/rules/java/java-core-language/references/modern-java-features.md +168 -0
package/rules/java/java-project-structure/SKILL.md +195 -0
package/rules/java/java-project-structure/references/REFERENCE.md +15 -0
package/rules/java/java-project-structure/references/maven-project-layout.md +199 -0
package/rules/java/java-project-structure/references/module-system.md +159 -0
package/rules/java/micronaut-core/SKILL.md +99 -0
package/rules/java/micronaut-core/references/REFERENCE.md +12 -0
package/rules/java/micronaut-reactive/SKILL.md +68 -0
package/rules/java/micronaut-reactive/references/REFERENCE.md +12 -0
package/rules/java/quarkus-core/SKILL.md +85 -0
package/rules/java/quarkus-core/references/REFERENCE.md +12 -0
package/rules/java/quarkus-reactive/SKILL.md +67 -0
package/rules/java/quarkus-reactive/references/REFERENCE.md +12 -0
package/rules/java/spring-batch/SKILL.md +102 -0
package/rules/java/spring-batch/references/REFERENCE.md +12 -0
package/rules/java/spring-boot-architecture/SKILL.md +206 -0
package/rules/java/spring-boot-architecture/references/REFERENCE.md +15 -0
package/rules/java/spring-boot-architecture/references/auto-configuration.md +158 -0
package/rules/java/spring-boot-architecture/references/configuration-properties.md +202 -0
package/rules/java/spring-boot-web/SKILL.md +217 -0
package/rules/java/spring-boot-web/references/REFERENCE.md +17 -0
package/rules/java/spring-cloud/SKILL.md +109 -0
package/rules/java/spring-cloud/references/REFERENCE.md +13 -0
package/rules/java/spring-data-jpa/SKILL.md +241 -0
package/rules/java/spring-data-jpa/references/REFERENCE.md +16 -0
package/rules/java/spring-security/SKILL.md +161 -0
package/rules/java/spring-security/references/REFERENCE.md +16 -0
package/rules/java/spring-security/references/jwt-auth-flow.md +213 -0
package/rules/java/testing-junit-mockito/SKILL.md +135 -0
package/rules/java/testing-junit-mockito/references/REFERENCE.md +15 -0
package/rules/java/testing-junit-mockito/references/junit5-patterns.md +159 -0
package/rules/java/testing-junit-mockito/references/mockito-patterns.md +148 -0
package/rules/java/testing-junit-mockito/references/spring-boot-testing.md +152 -0
package/rules/javascript/best-practices/SKILL.md +64 -0
package/rules/javascript/best-practices/references/REFERENCE.md +91 -0
package/rules/javascript/language/SKILL.md +71 -0
package/rules/javascript/language/references/REFERENCE.md +106 -0
package/rules/javascript/tooling/SKILL.md +60 -0
package/rules/javascript/tooling/references/REFERENCE.md +107 -0
package/rules/metadata.json +54 -0
package/rules/nestjs/api-standards/SKILL.md +47 -0
package/rules/nestjs/api-standards/references/pagination-wrapper.md +87 -0
package/rules/nestjs/architecture/SKILL.md +68 -0
package/rules/nestjs/architecture/references/dynamic-module.md +53 -0
package/rules/nestjs/caching/SKILL.md +51 -0
package/rules/nestjs/caching/references/REFERENCE.md +13 -0
package/rules/nestjs/caching/references/cache-patterns.md +183 -0
package/rules/nestjs/configuration/SKILL.md +41 -0
package/rules/nestjs/configuration/references/REFERENCE.md +13 -0
package/rules/nestjs/configuration/references/config-patterns.md +184 -0
package/rules/nestjs/controllers-services/SKILL.md +63 -0
package/rules/nestjs/controllers-services/references/REFERENCE.md +14 -0
package/rules/nestjs/controllers-services/references/controller-patterns.md +119 -0
package/rules/nestjs/controllers-services/references/service-patterns.md +129 -0
package/rules/nestjs/database/SKILL.md +102 -0
package/rules/nestjs/database/references/REFERENCE.md +14 -0
package/rules/nestjs/database/references/typeorm-patterns.md +156 -0
package/rules/nestjs/deployment/SKILL.md +36 -0
package/rules/nestjs/deployment/references/REFERENCE.md +13 -0
package/rules/nestjs/deployment/references/deployment-patterns.md +140 -0
package/rules/nestjs/documentation/SKILL.md +64 -0
package/rules/nestjs/documentation/references/REFERENCE.md +13 -0
package/rules/nestjs/documentation/references/swagger-patterns.md +139 -0
package/rules/nestjs/error-handling/SKILL.md +55 -0
package/rules/nestjs/error-handling/references/REFERENCE.md +13 -0
package/rules/nestjs/error-handling/references/exception-filters.md +152 -0
package/rules/nestjs/file-uploads/SKILL.md +35 -0
package/rules/nestjs/file-uploads/references/REFERENCE.md +13 -0
package/rules/nestjs/file-uploads/references/upload-patterns.md +125 -0
package/rules/nestjs/observability/SKILL.md +39 -0
package/rules/nestjs/observability/references/REFERENCE.md +13 -0
package/rules/nestjs/observability/references/logging-metrics.md +175 -0
package/rules/nestjs/performance/SKILL.md +60 -0
package/rules/nestjs/performance/references/REFERENCE.md +13 -0
package/rules/nestjs/performance/references/performance-patterns.md +107 -0
package/rules/nestjs/real-time/SKILL.md +45 -0
package/rules/nestjs/real-time/references/REFERENCE.md +13 -0
package/rules/nestjs/real-time/references/websocket-patterns.md +121 -0
package/rules/nestjs/scheduling/SKILL.md +39 -0
package/rules/nestjs/scheduling/references/REFERENCE.md +13 -0
package/rules/nestjs/scheduling/references/scheduling-patterns.md +137 -0
package/rules/nestjs/search/SKILL.md +41 -0
package/rules/nestjs/search/references/REFERENCE.md +13 -0
package/rules/nestjs/search/references/search-patterns.md +137 -0
package/rules/nestjs/security/SKILL.md +87 -0
package/rules/nestjs/security/references/REFERENCE.md +14 -0
package/rules/nestjs/security/references/authentication.md +151 -0
package/rules/nestjs/testing/SKILL.md +40 -0
package/rules/nestjs/testing/references/REFERENCE.md +14 -0
package/rules/nestjs/testing/references/unit-testing.md +179 -0
package/rules/nestjs/transport/SKILL.md +45 -0
package/rules/nestjs/transport/references/REFERENCE.md +13 -0
package/rules/nestjs/transport/references/microservices-patterns.md +170 -0
package/rules/nextjs/app-router/SKILL.md +46 -0
package/rules/nextjs/app-router/references/REFERENCE.md +14 -0
package/rules/nextjs/app-router/references/routing-patterns.md +182 -0
package/rules/nextjs/architecture/SKILL.md +44 -0
package/rules/nextjs/architecture/references/fsd-structure.md +77 -0
package/rules/nextjs/authentication/SKILL.md +29 -0
package/rules/nextjs/authentication/references/auth-implementation.md +73 -0
package/rules/nextjs/caching/SKILL.md +66 -0
package/rules/nextjs/caching/references/REFERENCE.md +13 -0
package/rules/nextjs/caching/references/cache-strategies.md +168 -0
package/rules/nextjs/data-access-layer/SKILL.md +33 -0
package/rules/nextjs/data-access-layer/references/patterns.md +66 -0
package/rules/nextjs/data-fetching/SKILL.md +59 -0
package/rules/nextjs/data-fetching/references/REFERENCE.md +13 -0
package/rules/nextjs/data-fetching/references/fetch-patterns.md +160 -0
package/rules/nextjs/internationalization/SKILL.md +105 -0
package/rules/nextjs/internationalization/references/REFERENCE.md +13 -0
package/rules/nextjs/internationalization/references/i18n-patterns.md +180 -0
package/rules/nextjs/optimization/SKILL.md +64 -0
package/rules/nextjs/optimization/references/REFERENCE.md +13 -0
package/rules/nextjs/optimization/references/optimization-patterns.md +190 -0
package/rules/nextjs/rendering/SKILL.md +91 -0
package/rules/nextjs/rendering/references/REFERENCE.md +13 -0
package/rules/nextjs/rendering/references/rendering-modes.md +163 -0
package/rules/nextjs/server-actions/SKILL.md +46 -0
package/rules/nextjs/server-actions/references/REFERENCE.md +13 -0
package/rules/nextjs/server-actions/references/action-patterns.md +188 -0
package/rules/nextjs/server-components/SKILL.md +52 -0
package/rules/nextjs/server-components/references/REFERENCE.md +13 -0
package/rules/nextjs/server-components/references/component-patterns.md +175 -0
package/rules/nextjs/state-management/SKILL.md +73 -0
package/rules/nextjs/state-management/references/REFERENCE.md +13 -0
package/rules/nextjs/state-management/references/state-patterns.md +218 -0
package/rules/nextjs/styling/SKILL.md +31 -0
package/rules/nextjs/styling/references/implementation.md +56 -0
package/rules/react/component-patterns/SKILL.md +66 -0
package/rules/react/component-patterns/references/REFERENCE.md +126 -0
package/rules/react/hooks/SKILL.md +60 -0
package/rules/react/hooks/references/REFERENCE.md +132 -0
package/rules/react/hooks.rule.md +79 -0
package/rules/react/performance/SKILL.md +69 -0
package/rules/react/performance/references/REFERENCE.md +143 -0
package/rules/react/security/SKILL.md +46 -0
package/rules/react/security/references/REFERENCE.md +170 -0
package/rules/react/state-management/SKILL.md +56 -0
package/rules/react/state-management/references/REFERENCE.md +137 -0
package/rules/react/testing/SKILL.md +45 -0
package/rules/react/testing/references/REFERENCE.md +149 -0
package/rules/react/tooling/SKILL.md +39 -0
package/rules/react/typescript/SKILL.md +53 -0
package/rules/rust/actix-web/SKILL.md +160 -0
package/rules/rust/actix-web/references/REFERENCE.md +13 -0
package/rules/rust/actix-web/references/handler-patterns.md +198 -0
package/rules/rust/async-graphql/SKILL.md +228 -0
package/rules/rust/async-graphql/references/REFERENCE.md +13 -0
package/rules/rust/async-graphql/references/schema-patterns.md +215 -0
package/rules/rust/axum/SKILL.md +161 -0
package/rules/rust/axum/references/REFERENCE.md +14 -0
package/rules/rust/axum/references/handler-patterns.md +97 -0
package/rules/rust/bevy/SKILL.md +206 -0
package/rules/rust/bevy/references/REFERENCE.md +13 -0
package/rules/rust/bevy/references/ecs-patterns.md +226 -0
package/rules/rust/clap/SKILL.md +217 -0
package/rules/rust/clap/references/REFERENCE.md +13 -0
package/rules/rust/clap/references/derive-patterns.md +205 -0
package/rules/rust/core/SKILL.md +154 -0
package/rules/rust/core/references/REFERENCE.md +14 -0
package/rules/rust/core/references/error-handling.md +92 -0
package/rules/rust/diesel-orm/SKILL.md +176 -0
package/rules/rust/diesel-orm/references/REFERENCE.md +13 -0
package/rules/rust/diesel-orm/references/schema-patterns.md +206 -0
package/rules/rust/rocket/SKILL.md +182 -0
package/rules/rust/rocket/references/REFERENCE.md +13 -0
package/rules/rust/rocket/references/handler-patterns.md +209 -0
package/rules/rust/sea-orm/SKILL.md +230 -0
package/rules/rust/sea-orm/references/REFERENCE.md +13 -0
package/rules/rust/sea-orm/references/entity-patterns.md +221 -0
package/rules/rust/serde-serialization/SKILL.md +150 -0
package/rules/rust/serde-serialization/references/REFERENCE.md +13 -0
package/rules/rust/serde-serialization/references/serialization-patterns.md +199 -0
package/rules/rust/sqlx-database/SKILL.md +140 -0
package/rules/rust/sqlx-database/references/REFERENCE.md +13 -0
package/rules/rust/sqlx-database/references/query-patterns.md +210 -0
package/rules/rust/tauri/SKILL.md +180 -0
package/rules/rust/tauri/references/REFERENCE.md +13 -0
package/rules/rust/tauri/references/command-patterns.md +209 -0
package/rules/rust/tokio-runtime/SKILL.md +167 -0
package/rules/rust/tokio-runtime/references/REFERENCE.md +14 -0
package/rules/rust/tokio-runtime/references/async-patterns.md +137 -0
package/rules/rust/tokio-runtime/references/synchronization.md +152 -0
package/rules/rust/tonic/SKILL.md +231 -0
package/rules/rust/tonic/references/REFERENCE.md +13 -0
package/rules/rust/tonic/references/service-patterns.md +213 -0
package/rules/rust/tracing/SKILL.md +214 -0
package/rules/rust/tracing/references/REFERENCE.md +13 -0
package/rules/rust/tracing/references/instrumentation.md +187 -0
package/rules/typescript/best-practices/SKILL.md +108 -0
package/rules/typescript/best-practices/references/REFERENCE.md +68 -0
package/rules/typescript/language/SKILL.md +72 -0
package/rules/typescript/language/references/REFERENCE.md +67 -0
package/rules/typescript/patterns.rule.md +85 -0
package/rules/typescript/security/SKILL.md +59 -0
package/rules/typescript/security/references/REFERENCE.md +113 -0
package/rules/typescript/tooling/SKILL.md +52 -0
package/rules/typescript/tooling/references/REFERENCE.md +110 -0

package/rules/nextjs/optimization/references/optimization-patterns.md ADDED Viewed

@@ -0,0 +1,190 @@
+# Next.js Optimization Patterns
+## Image Optimization
+```typescript
+import Image from 'next/image';
+// Basic responsive image
+<Image
+  src="/hero.jpg"
+  alt="Hero"
+  width={1200}
+  height={600}
+  priority // Load immediately for LCP
+/>
+// Fill container
+<div className="relative h-64 w-full">
+  <Image
+    src="/background.jpg"
+    alt="Background"
+    fill
+    sizes="100vw"
+    style={{ objectFit: 'cover' }}
+  />
+</div>
+// Responsive with sizes
+<Image
+  src="/product.jpg"
+  alt="Product"
+  width={800}
+  height={600}
+  sizes="(max-width: 768px) 100vw, (max-width: 1200px) 50vw, 33vw"
+/>
+// Blur placeholder
+<Image
+  src="/photo.jpg"
+  alt="Photo"
+  width={400}
+  height={300}
+  placeholder="blur"
+  blurDataURL="data:image/jpeg;base64,..."
+/>
+```
+## Font Optimization
+```typescript
+// app/layout.tsx
+import { Inter, Roboto_Mono } from 'next/font/google';
+const inter = Inter({
+  subsets: ['latin'],
+  display: 'swap',
+  variable: '--font-inter',
+});
+const robotoMono = Roboto_Mono({
+  subsets: ['latin'],
+  display: 'swap',
+  variable: '--font-roboto-mono',
+});
+export default function RootLayout({ children }) {
+  return (
+    <html lang="en" className={`${inter.variable} ${robotoMono.variable}`}>
+      <body className={inter.className}>{children}</body>
+    </html>
+  );
+}
+// Local fonts
+import localFont from 'next/font/local';
+const myFont = localFont({
+  src: './fonts/MyFont.woff2',
+  display: 'swap',
+});
+```
+## Script Optimization
+```typescript
+import Script from 'next/script';
+// After page interactive (default)
+<Script src="https://example.com/analytics.js" />
+// Before page hydration
+<Script src="https://polyfill.io/v3/polyfill.min.js" strategy="beforeInteractive" />
+// After page load
+<Script src="https://example.com/chat-widget.js" strategy="lazyOnload" />
+// With onLoad callback
+<Script
+  src="https://maps.googleapis.com/maps/api/js"
+  onLoad={() => console.log('Google Maps loaded')}
+/>
+// Inline script
+<Script id="schema-org" type="application/ld+json">
+  {JSON.stringify(structuredData)}
+</Script>
+```
+## Dynamic Imports
+```typescript
+import dynamic from 'next/dynamic';
+// Lazy load component
+const DynamicChart = dynamic(() => import('../components/Chart'), {
+  loading: () => <p>Loading chart...</p>,
+});
+// Disable SSR for client-only components
+const DynamicMap = dynamic(() => import('../components/Map'), {
+  ssr: false,
+});
+// Named export
+const DynamicModal = dynamic(
+  () => import('../components/Modal').then((mod) => mod.Modal)
+);
+```
+## Bundle Analysis
+```javascript
+// next.config.js
+const withBundleAnalyzer = require('@next/bundle-analyzer')({
+  enabled: process.env.ANALYZE === 'true',
+});
+module.exports = withBundleAnalyzer({
+  // config
+});
+// Run: ANALYZE=true npm run build
+```
+## Metadata Optimization
+```typescript
+// app/layout.tsx
+import { Metadata } from 'next';
+export const metadata: Metadata = {
+  title: {
+    template: '%s | My App',
+    default: 'My App',
+  },
+  description: 'My app description',
+  openGraph: {
+    images: ['/og-image.jpg'],
+  },
+  robots: {
+    index: true,
+    follow: true,
+  },
+};
+// Dynamic metadata
+export async function generateMetadata({ params }): Promise<Metadata> {
+  const product = await getProduct(params.id);
+  return {
+    title: product.name,
+    description: product.description,
+  };
+}
+```
+## Route Segment Config
+```typescript
+// Static generation with revalidation
+export const revalidate = 3600; // Revalidate every hour
+// Force dynamic rendering
+export const dynamic = 'force-dynamic';
+// Force static rendering
+export const dynamic = 'force-static';
+// Runtime selection
+export const runtime = 'edge'; // or 'nodejs'
+```

package/rules/nextjs/rendering/SKILL.md ADDED Viewed

@@ -0,0 +1,91 @@
+---
+name: Next.js Rendering Strategies
+description: SSG, SSR, ISR, Streaming, and Partial Prerendering (PPR).
+metadata:
+  labels: [nextjs, rendering, isr, ssr, ssg]
+  triggers:
+    files: ['**/page.tsx', '**/layout.tsx']
+    keywords: [generateStaticParams, dynamic, dynamicParams, PPR, streaming]
+---
+# Rendering Strategies (App Router)
+## **Priority: P0 (CRITICAL)**
+Understanding how Next.js renders content determines performance and cost.
+## Strategy Selection Matrix (Scaling & Cost)
+| Strategy | Ideal For              | Data Freshness       | Performance (TTFB)          | Scaling Risk                         |
+| :------- | :--------------------- | :------------------- | :-------------------------- | :----------------------------------- |
+| **SSG**  | Marketing, Docs, Blogs | Build Time           | **Instant** (CDN)           | **None**                             |
+| **ISR**  | E-commerce, CMS        | Periodic (e.g., 60s) | **Instant** (CDN)           | **Low** (Background Rebuilds)        |
+| **SSR**  | Dashboards, Auth Gates | Real-Time (Request)  | **Slow** (Waits for Server) | **Critical** (1 Request = 1 Compute) |
+| **PPR**  | Personalized Apps      | Hybrid               | **Instant** (Shell)         | **Medium** (Streaming Holes)         |
+## Scaling Patterns
+### 1. The "Static Shell" Pattern (Preferred)
+- **Goal**: Make most of the page **Static** to hit the CDN cache.
+- **Pattern**:
+  - Render the generic layout (Logo, Footer, Navigation) as **Static**.
+  - Wrap personalized/slow components (User Profile, Cart Count, Recommendations) in `<Suspense>`.
+- **Result**: **TTFB (Time to First Byte)** is near-instant (~50ms) because the shell is cached. User perception is fast, even if DB is slow.
+### 2. Avoiding "SSR Waterfalls"
+- **Problem**: In naive SSR, the server waits for _every_ fetch to finish before sending _any_ HTML.
+  - _Scenario_: DB Call (200ms) + Auth Check (100ms) + 3rd Party API (500ms) = Blank screen for 800ms.
+- **Solution**:
+  - Move slow fetches **down** the component tree into Suspense boundaries.
+  - Do not `await` everything in the root `page.tsx`.
+## 1. Static Rendering (SSG) - **Default**
+- **Behavior**: Routes are rendered at **build time**.
+- **Usage**: Marketing pages, Blogs, Documentation.
+- **Dynamic Routes**: Use `generateStaticParams` to generate static pages for dynamic paths (e.g., `/blog/[slug]`).
+  ```tsx
+  export async function generateStaticParams() {
+    const posts = await getPosts();
+    return posts.map((post) => ({ slug: post.slug }));
+  }
+  ```
+## 2. Dynamic Rendering (SSR)
+- **Behavior**: Routes are rendered at **request time**.
+- **Triggers**:
+  - Using Dynamic Functions: `cookies()`, `headers()`, `searchParams`.
+  - Using Dynamic Fetch: `fetch(..., { cache: 'no-store' })`.
+  - Explicit Config: `export const dynamic = 'force-dynamic'`.
+## 3. Streaming (Suspense)
+- **Problem**: SSR blocks the entire page until all data is ready.
+- **Solution**: Wrap slow components in `<Suspense>`. Next.js instantly sends the initial HTML (static shell) and streams the slow content later.
+  ```tsx
+  <Suspense fallback={<Skeleton />}>
+    <SlowDashboard />
+  </Suspense>
+  ```
+## 4. Incremental Static Regeneration (ISR)
+- **Behavior**: Update static content after build time without rebuilding the entire site.
+- **Time-based**: `export const revalidate = 3600;` (in layout/page) or `{ next: { revalidate: 3600 } }` (in fetch).
+- **On-Demand**: `revalidatePath('/posts')` via Server Actions or Webhooks.
+## 5. Partial Prerendering (PPR) - _Experimental_
+- **Concept**: Combines Static shell + Dynamic holes.
+- **Config**: `export const experimental_ppr = true`.
+- **Behavior**: The build generates a static shell for the route (served instantly from Edge), and dynamic parts stream in.
+## Runtime Configuration
+- **Node.js (Default)**: Full Node.js API support.
+- **Edge**: `export const runtime = 'edge'`. Limited API, starts instantly, lower cost.

package/rules/nextjs/rendering/references/REFERENCE.md ADDED Viewed

@@ -0,0 +1,13 @@
+# Next.js Rendering References
+## References
+- [**Rendering Modes**](rendering-modes.md) - Static, Dynamic, Streaming
+## Quick Checks
+- [ ] Static by default for performance
+- [ ] Dynamic when data changes per request
+- [ ] Streaming for improved TTFB
+- [ ] PPR for best of both worlds
+- [ ] Understand rendering boundaries

package/rules/nextjs/rendering/references/rendering-modes.md ADDED Viewed

@@ -0,0 +1,163 @@
+# Next.js Rendering Modes
+## Static Rendering (Default)
+```tsx
+// Rendered at build time
+async function BlogPage() {
+  const posts = await getPosts(); // Cached
+  return <PostList posts={posts} />;
+}
+// Generate static pages for dynamic routes
+export async function generateStaticParams() {
+  const posts = await getPosts();
+  return posts.map((post) => ({ slug: post.slug }));
+}
+// With revalidation (ISR)
+export const revalidate = 3600; // Regenerate every hour
+```
+## Dynamic Rendering
+```tsx
+// Force dynamic rendering
+export const dynamic = 'force-dynamic';
+// Automatic dynamic - using dynamic functions
+import { cookies, headers } from 'next/headers';
+async function Page() {
+  const cookieStore = await cookies();
+  const token = cookieStore.get('token');
+  // Now renders dynamically
+  return <Dashboard token={token} />;
+}
+// Dynamic with searchParams
+async function SearchPage({
+  searchParams
+}: {
+  searchParams: Promise<{ q: string }>
+}) {
+  const { q } = await searchParams;
+  const results = await search(q);
+  return <Results data={results} />;
+}
+```
+## Streaming
+```tsx
+import { Suspense } from 'react';
+// Progressive rendering with streaming
+async function Page() {
+  return (
+    <div>
+      {/* Renders immediately */}
+      <Header />
+      {/* Streams when ready */}
+      <Suspense fallback={<RecommendationsSkeleton />}>
+        <Recommendations />
+      </Suspense>
+      <Suspense fallback={<ReviewsSkeleton />}>
+        <Reviews />
+      </Suspense>
+    </div>
+  );
+}
+// loading.tsx provides route-level streaming
+// app/dashboard/loading.tsx
+export default function Loading() {
+  return <DashboardSkeleton />;
+}
+```
+## Partial Prerendering (PPR)
+```tsx
+// next.config.js
+module.exports = {
+  experimental: {
+    ppr: true,
+  },
+};
+// Static shell with dynamic holes
+async function Page() {
+  return (
+    <div>
+      {/* Static - prerendered */}
+      <Header />
+      <Hero />
+      {/* Dynamic - streamed */}
+      <Suspense fallback={<CartSkeleton />}>
+        <Cart /> {/* Uses cookies */}
+      </Suspense>
+      {/* Static */}
+      <Footer />
+    </div>
+  );
+}
+```
+## Edge Runtime
+```tsx
+// Run at the edge for lower latency
+export const runtime = 'edge';
+async function Page() {
+  // Limited Node.js APIs
+  // Fast cold starts
+  return <Content />;
+}
+// Middleware always runs on edge
+// middleware.ts
+import { NextResponse } from 'next/server';
+export function middleware(request: Request) {
+  return NextResponse.next();
+}
+```
+## Rendering Decision Tree
+```
+Is data static?
+├── Yes → Static Rendering (SSG)
+│   └── Need periodic updates? → ISR (revalidate)
+└── No → Dynamic Rendering
+    ├── Per-request data (cookies, headers) → Server
+    ├── Real-time data → Client + SWR/React Query
+    └── Mix of static + dynamic → PPR + Suspense
+```
+## Client-Side Rendering
+```tsx
+'use client';
+import useSWR from 'swr';
+// Real-time or frequently changing data
+function StockPrice({ symbol }: { symbol: string }) {
+  const { data, error, isLoading } = useSWR(
+    `/api/stocks/${symbol}`,
+    fetcher,
+    { refreshInterval: 1000 }
+  );
+  if (isLoading) return <Skeleton />;
+  if (error) return <Error />;
+  return <Price value={data.price} />;
+}
+```

package/rules/nextjs/server-actions/SKILL.md ADDED Viewed

@@ -0,0 +1,46 @@
+---
+name: Next.js Server Actions
+description: Mutations, Form handling, and RPC-style calls.
+metadata:
+  labels: [nextjs, actions, mutations]
+  triggers:
+    files: ['**/actions.ts', '**/*.tsx']
+    keywords: [use server, Server Action, revalidatePath, useFormStatus]
+---
+# Server Actions
+## **Priority: P1 (HIGH)**
+Handle form submissions and mutations without creating API endpoints.
+## Implementation
+- **Directive**: Add `'use server'` at the top of an async function.
+- **Usage**: Pass to `action` prop of `<form>` or invoke from event handlers.
+```tsx
+// actions.ts
+'use server';
+export async function createPost(formData: FormData) {
+  const title = formData.get('title');
+  await db.post.create({ title });
+  revalidatePath('/posts'); // Refresh UI
+}
+```
+## Client Invocation
+- **Form**: `<form action={createPost}>` (Progressive enhancements work without JS).
+- **Event Handler**: `onClick={() => createPost(data)}`.
+- **Pending State**: Use `useFormStatus` hook (must be inside a component rendered within the form).
+## Validation & Error Handling
+- **Zod**: Always validate `FormData` or arguments on the server.
+- **Return Values**: Return serializable objects `{ success: boolean, error?: string }` to handle feedback on Client.
+## Security
+- **Authentication**: Check `auth()` (e.g., NextAuth) session inside every Server Action.
+- **Closure**: Be careful with closures in Server Actions defined inside Components (they capture context encrypted). Prefer defining actions in separate files (`actions.ts`).

package/rules/nextjs/server-actions/references/REFERENCE.md ADDED Viewed

@@ -0,0 +1,13 @@
+# Next.js Server Actions References
+## References
+- [**Action Patterns**](action-patterns.md) - Forms, mutations, revalidation
+## Quick Checks
+- [ ] Use 'use server' directive
+- [ ] Validate inputs on server
+- [ ] Use useActionState for forms
+- [ ] Revalidate after mutations
+- [ ] Handle errors appropriately

package/rules/nextjs/server-actions/references/action-patterns.md ADDED Viewed

@@ -0,0 +1,188 @@
+# Next.js Server Action Patterns
+## Basic Actions
+```tsx
+// app/actions.ts
+'use server';
+import { revalidatePath } from 'next/cache';
+export async function createPost(formData: FormData) {
+  const title = formData.get('title') as string;
+  const content = formData.get('content') as string;
+  await db.post.create({ data: { title, content } });
+  revalidatePath('/posts');
+}
+// In component
+import { createPost } from './actions';
+function CreatePostForm() {
+  return (
+    <form action={createPost}>
+      <input name="title" required />
+      <textarea name="content" required />
+      <button type="submit">Create</button>
+    </form>
+  );
+}
+```
+## With useActionState
+```tsx
+'use client';
+import { useActionState } from 'react';
+import { createPost } from './actions';
+function CreatePostForm() {
+  const [state, action, pending] = useActionState(createPost, null);
+  return (
+    <form action={action}>
+      <input name="title" required />
+      <textarea name="content" required />
+      {state?.error && <p className="error">{state.error}</p>}
+      <button type="submit" disabled={pending}>
+        {pending ? 'Creating...' : 'Create Post'}
+      </button>
+    </form>
+  );
+}
+// Action with state
+'use server';
+export async function createPost(prevState: any, formData: FormData) {
+  const title = formData.get('title') as string;
+  if (!title || title.length < 3) {
+    return { error: 'Title must be at least 3 characters' };
+  }
+  try {
+    await db.post.create({ data: { title } });
+    revalidatePath('/posts');
+    return { success: true };
+  } catch (e) {
+    return { error: 'Failed to create post' };
+  }
+}
+```
+## Validation with Zod
+```tsx
+'use server';
+import { z } from 'zod';
+const CreatePostSchema = z.object({
+  title: z.string().min(3).max(100),
+  content: z.string().min(10),
+});
+export async function createPost(prevState: any, formData: FormData) {
+  const validatedFields = CreatePostSchema.safeParse({
+    title: formData.get('title'),
+    content: formData.get('content'),
+  });
+  if (!validatedFields.success) {
+    return {
+      errors: validatedFields.error.flatten().fieldErrors,
+    };
+  }
+  const { title, content } = validatedFields.data;
+  await db.post.create({ data: { title, content } });
+  revalidatePath('/posts');
+  redirect('/posts');
+}
+```
+## Programmatic Invocation
+```tsx
+'use client';
+import { deletePost } from './actions';
+function DeleteButton({ id }: { id: string }) {
+  async function handleDelete() {
+    if (confirm('Delete this post?')) {
+      await deletePost(id);
+    }
+  }
+  return <button onClick={handleDelete}>Delete</button>;
+}
+// Action
+'use server';
+export async function deletePost(id: string) {
+  await db.post.delete({ where: { id } });
+  revalidatePath('/posts');
+}
+```
+## With useOptimistic
+```tsx
+'use client';
+import { useOptimistic } from 'react';
+import { likePost } from './actions';
+function LikeButton({ postId, likes }: { postId: string; likes: number }) {
+  const [optimisticLikes, addOptimisticLike] = useOptimistic(
+    likes,
+    (state) => state + 1
+  );
+  async function handleLike() {
+    addOptimisticLike(null);
+    await likePost(postId);
+  }
+  return (
+    <button onClick={handleLike}>
+      ❤️ {optimisticLikes}
+    </button>
+  );
+}
+```
+## File Uploads
+```tsx
+'use server';
+export async function uploadFile(formData: FormData) {
+  const file = formData.get('file') as File;
+  if (!file || file.size === 0) {
+    return { error: 'No file provided' };
+  }
+  const bytes = await file.arrayBuffer();
+  const buffer = Buffer.from(bytes);
+  const path = `/uploads/${file.name}`;
+  await writeFile(path, buffer);
+  return { url: path };
+}
+// Form
+<form action={uploadFile}>
+  <input type="file" name="file" required />
+  <button type="submit">Upload</button>
+</form>
+```