matraic · Aditya1234vishwakarma · Mar 6, 2026
diff --git a/packages/nextjs/.gitignore b/packages/nextjs/.gitignore
@@ -0,0 +1,41 @@
+# See https://help.github.com/articles/ignoring-files/ for more about ignoring files.
+
+# dependencies
+/node_modules
+/.pnp
+.pnp.*
+.yarn/*
+!.yarn/patches
+!.yarn/plugins
+!.yarn/releases
+!.yarn/versions
+
+# testing
+/coverage
+
+# next.js
+/.next/
+/out/
+
+# production
+/build
+
+# misc
+.DS_Store
+*.pem
+
+# debug
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+.pnpm-debug.log*
+
+# env files (can opt-in for committing if needed)
+.env*
+
+# vercel
+.vercel
+
+# typescript
+*.tsbuildinfo
+next-env.d.ts
diff --git a/packages/nextjs/README.md b/packages/nextjs/README.md
@@ -0,0 +1,31 @@
+# @m3e/nextjs
+
+The `@m3e/nextjs` package provides idiomatic, typed dynamic imports in nextjs for M3E Web Components, exposing their properties, attributes, and native DOM events through a familiar React interface with full ref forwarding and client‑only compatibility.
+
+The React bindings are client-only and must be used inside a `"use client"` an also works without this `"use client"` because Dynamic Import is Used boundary in your application.
+
+To support Next.js and SSR, `@m3e/web` works with Lit's server-ready modules, and consumers only need to wrap their `next.config.js` with `withLitSSR` from `@lit-labs/nextjs`. This lets Next.js load the correct server build instead of evaluating browser code during rendering, so all `@m3e/web` elements render on the server and hydrate on the client without any extra setup.
+
+## 🧪 Example
+
+The following example demonstrates how to use the `M3eButton` React binding from `@m3e/nextjs/button`.
+
+```tsx
+"use client";
+
+import { M3eButton, M3eButtonElement } from "@m3e/nextjs/button";
+import {useRef} from "react";
+
+export default function ClickExample() {
+    const buttonRef = useRef<M3eButtonElement>();
+  return <M3eButton onClick={() => console.log("Button clicked!")}>Click me</M3eButton>;
+}
+```
+
+## 🤝 Contributing
+
+See the root monorepo `CONTRIBUTING.md` for guidelines on contributing to this package.
+
+## 📄 License
+
+This package is licensed under the MIT License.
diff --git a/packages/nextjs/app/globals.css b/packages/nextjs/app/globals.css
diff --git a/packages/nextjs/app/layout.tsx b/packages/nextjs/app/layout.tsx
@@ -0,0 +1,32 @@
+import type { Metadata } from "next";
+import { Geist, Geist_Mono } from "next/font/google";
+import "./globals.css";
+
+const geistSans = Geist({
+  variable: "--font-geist-sans",
+  subsets: ["latin"],
+});
+
+const geistMono = Geist_Mono({
+  variable: "--font-geist-mono",
+  subsets: ["latin"],
+});
+
+export const metadata: Metadata = {
+  title: "M3e for NEXTJS",
+  description: "This is a key library for next js powered by @m3e/react use only for the famous framework nextjs 16 app router",
+};
+
+export default function RootLayout({
+  children,
+}: Readonly<{
+  children: React.ReactNode;
+}>) {
+  return (
+    <html lang="en">
+      <body className={`${geistSans.variable} ${geistMono.variable}`}>
+        {children}
+      </body>
+    </html>
+  );
+}
diff --git a/packages/nextjs/app/page.module.css b/packages/nextjs/app/page.module.css
diff --git a/packages/nextjs/app/page.tsx b/packages/nextjs/app/page.tsx
@@ -0,0 +1,5 @@
+export default function Home() {
+  return (
+    <div>npm i @m3e/nextjs</div>
+  );
+}
diff --git a/packages/nextjs/eslint.config.mjs b/packages/nextjs/eslint.config.mjs
@@ -0,0 +1,18 @@
+import { defineConfig, globalIgnores } from "eslint/config";
+import nextVitals from "eslint-config-next/core-web-vitals";
+import nextTs from "eslint-config-next/typescript";
+
+const eslintConfig = defineConfig([
+  ...nextVitals,
+  ...nextTs,
+  // Override default ignores of eslint-config-next.
+  globalIgnores([
+    // Default ignores of eslint-config-next:
+    ".next/**",
+    "out/**",
+    "build/**",
+    "next-env.d.ts",
+  ]),
+]);
+
+export default eslintConfig;
diff --git a/packages/nextjs/next.config.ts b/packages/nextjs/next.config.ts
@@ -0,0 +1,8 @@
+import type { NextConfig } from "next";
+
+const nextConfig: NextConfig = {
+  /* config options here */
+  reactCompiler: true,
+};
+
+export default nextConfig;