feat/n1

.gitignore

@@ -53,6 +53,7 @@ test-output
 
 # MCP configuration
 .mcp.json
+.schaltwerk/
 
 # Frontend demo test pages
 .next/

apps/n1/.env.example

@@ -0,0 +1,22 @@
+NEXT_PUBLIC_MEDUSA_BACKEND_URL=
+NEXT_PUBLIC_MEDUSA_PUBLISHABLE_KEY=
+RESEND_API_KEY=
+CONTACT_EMAIL=
+RESEND_FROM_EMAIL=
+
+NEXT_PUBLIC_MEILISEARCH_URL=
+NEXT_PUBLIC_MEILISEARCH_API_KEY=
+
+# Analytics - Meta Pixel (https://business.facebook.com/events_manager)
+NEXT_PUBLIC_META_PIXEL_ID=
+
+# Analytics - Google Ads (https://ads.google.com → Nástroje → Konverze)
+NEXT_PUBLIC_GOOGLE_ADS_ID=
+
+# Analytics - Heureka (https://sluzby.heureka.cz → Měření konverzí)
+NEXT_PUBLIC_HEUREKA_API_KEY=
+
+# Analytics - Leadhub (https://app.leadhub.co → Leadhub pixel)
+NEXT_PUBLIC_LEADHUB_TRACKING_ID=
+
+NEXT_PUBLIC_SITE_URL=

apps/n1/AGENTS.md

@@ -0,0 +1,14 @@
+# N1 App
+
+## Critical Rules
+
+- No barrel files or re-export-only `index.ts` files. Import from source files directly.
+  - Why: Improves traceability, reduces circular dependency risk, and supports Nx module boundary enforcement.
+  - Example: `import { formatDate } from '@/utils/date/format-date'`
+- Always recheck everything before reporting done:
+  - Lint: `pnpm exec biome check apps/n1`
+  - Lint (workspace): `pnpm lint:nx`
+  - Typecheck: `pnpm exec tsc -p apps/n1/tsconfig.json --noEmit`
+  - Build: `pnpm -C apps/n1 build`
+  - UI build: `pnpm -C libs/ui build`
+  - UI storybook build: `pnpm -C libs/ui build:storybook`

apps/n1/CLAUDE.md

@@ -0,0 +1,164 @@
+# N1 E-commerce Application
+
+Next.js 16 e-commerce frontend for Medusa.js v2 backend.
+
+## CRITICAL RULES
+
+**ALWAYS:**
+- Assume dev server running on `localhost:3000` - NEVER ask to start it
+- Use spacing tokens `50-950` (NEVER `sm`/`md`/`lg`)
+- Use semantic color tokens (NEVER `bg-gray-100`, `text-blue-500`)
+- Read `local/docs/user/*.md` before cart/auth/checkout work
+
+**NEVER:**
+- Edit `package.json` manually - use `pnpm add <pkg>`
+- Use `forwardRef` or `useCallback` (React 19)
+- Create `tailwind.config.js` (Tailwind v4 uses CSS)
+- Use arbitrary values like `p-[20px]` or `bg-[#fff]`
+- Run `biome check --write .` - always specify files explicitly
+
+---
+
+## Tech Stack
+
+- **Framework:** Next.js 16 + Turbopack
+- **UI:** React 19 (ref as prop), Tailwind v4, react compiler
+- **State:** @tanstack/react-query v5
+- **Backend:** @medusajs/js-sdk
+- **Components:** @libs/ui (atomic design)
+
+---
+
+## Commands
+
+```bash
+pnpm dev                         # Dev server (assume running on :3000)
+pnpm build                       # Production build
+bunx tsc --noEmit               # Type check
+bunx biome check --write <files> # Lint + format (NEVER use `.`)
+pnpm add <pkg>                   # Add dependency
+pnpm add -D <pkg>                # Add dev dependency
+```
+
+---
+
+## Token Quick Reference
+
+### Spacing (ALWAYS 50-950)
+
+```typescript
+// ✅ CORRECT
+className="p-400 gap-600 m-200"
+
+// ❌ WRONG - DOES NOT EXIST
+className="p-md gap-lg m-sm"
+```
+
+| Token | Value | Use |
+|-------|-------|-----|
+| `200` | 8px | Tight |
+| `400` | 16px | Standard |
+| `600` | 24px | Section |
+| `800` | 40px | Large |
+
+### Colors (Semantic only)
+
+```typescript
+// ✅ CORRECT
+className="bg-primary text-fg-primary"
+className="bg-surface border-border-secondary"
+
+// ❌ WRONG - DOES NOT EXIST
+className="bg-gray-100 text-blue-500"
+```
+
+| Type | Tokens |
+|------|--------|
+| Brand | `primary`, `secondary`, `tertiary` |
+| Status | `success`, `warning`, `danger`, `info` |
+| Text | `fg-primary`, `fg-secondary`, `fg-reverse` |
+| Background | `base`, `surface`, `overlay` |
+| Border | `border-primary`, `border-secondary` |
+
+@./.claude/instructions/01-tokens.md
+
+---
+
+## Code Patterns
+
+### React 19
+
+```typescript
+// ✅ ref as prop (no forwardRef)
+function Button({ ref, onClick }: Props) {
+  return <button ref={ref} onClick={onClick} />
+}
+```
+
+### Imports
+
+```typescript
+// UI Library
+import { Button } from '@libs/ui/atoms/button'
+import { Dialog } from '@libs/ui/molecules/dialog'
+
+// Hooks
+import { useCart } from '@/hooks/use-cart'
+import { useAuth } from '@/hooks/use-auth'
+
+// Services
+import { getProducts } from '@/services/product-service'
+```
+
+@./.claude/instructions/02-code-patterns.md
+
+---
+
+## User Data System
+
+**REQUIRED READING before working on user features:**
+
+| Feature | Documentation |
+|---------|---------------|
+| **Start here** | `local/docs/user/index.md` |
+| Cart operations | `local/docs/user/cart.md` |
+| Checkout flow | `local/docs/user/checkout.md` |
+| Auth (login/register) | `local/docs/user/auth.md` |
+| Orders | `local/docs/user/orders.md` |
+| Addresses | `local/docs/user/addresses.md` |
+| Cache/prefetch | `local/docs/user/provider.md` |
+| Error handling | `local/docs/user/utilities.md` |
+
+**Key hooks:** `useCart`, `useAuth`, `useOrders`, `useAddresses`, `useCheckout`
+
+---
+
+## File Structure
+
+```
+src/
+├── app/              # Next.js app router
+├── components/       # App-specific components
+├── hooks/           # React Query hooks
+├── services/        # Medusa SDK services
+├── lib/             # Utilities, config
+└── tokens/          # Design tokens CSS
+```
+
+---
+
+## DO / DON'T
+
+| DO | DON'T |
+|----|-------|
+| `p-400`, `gap-600` | `p-md`, `gap-lg` |
+| `bg-primary`, `text-fg-primary` | `bg-gray-100`, `text-blue-500` |
+| Read `local/docs/user/*` first | Guess user data patterns |
+| `pnpm add <pkg>` | Edit package.json |
+| ref as prop (React 19) | forwardRef, useCallback |
+
+---
+
+**Token files:** `src/tokens/_n1-*.css`
+**UI Library:** `../../libs/ui/CLAUDE.md`
+**Last Updated:** 2025-01-25

apps/n1/netlify.toml

@@ -0,0 +1,13 @@
+[build]
+  base = "apps/n1"
+  command = "pnpm build"
+  publish = ".next"
+
+[build.environment]
+  NODE_VERSION = "22"
+
+[[plugins]]
+  package = "@netlify/plugin-nextjs"
+
+[functions]
+  included_files = ["!node_modules/@swc/**", "!node_modules/@rspack/**"]

apps/n1/next-env.d.ts

@@ -0,0 +1,6 @@
+/// <reference types="next" />
+/// <reference types="next/image-types/global" />
+import "./.next/types/routes.d.ts"
+
+// NOTE: This file should not be edited
+// see https://nextjs.org/docs/app/api-reference/config/typescript for more information.

apps/n1/next.config.ts

@@ -0,0 +1,80 @@
+import type { NextConfig } from "next"
+
+const nextConfig: NextConfig = {
+  reactStrictMode: true,
+  transpilePackages: ["@new-engine/ui", "@techsio/analytics"],
+  reactCompiler: true,
+  cacheComponents: true,
+  outputFileTracingExcludes: {
+    "*": [
+      "node_modules/@swc/core-linux-x64-gnu",
+      "node_modules/@swc/core-linux-x64-musl",
+      "node_modules/@esbuild",
+      "node_modules/@rspack",
+      "node_modules/webpack",
+      "node_modules/rollup",
+      "node_modules/terser",
+      "node_modules/uglify-js",
+      "node_modules/@zag-js",
+      "node_modules/puppeteer",
+    ],
+  },
+  images: {
+    remotePatterns: [
+      {
+        protocol: "https",
+        hostname: "pub-adde8a563e2c43f7b6bc296d81c86358.r2.dev",
+      },
+    ],
+    qualities: [40, 50, 60, 75, 90],
+  },
+
+  cacheLife: {
+    product: {
+      stale: 3600,
+      revalidate: 3600,
+      expire: 86_400,
+    },
+  },
+
+  experimental: {
+    typedEnv: true,
+  },
+
+  // Security headers
+  headers() {
+    return [
+      {
+        source: "/:path*",
+        headers: [
+          {
+            key: "X-Frame-Options",
+            value: "DENY",
+          },
+          {
+            key: "X-Content-Type-Options",
+            value: "nosniff",
+          },
+          {
+            key: "Referrer-Policy",
+            value: "origin-when-cross-origin",
+          },
+          {
+            key: "Permissions-Policy",
+            value: "camera=(), microphone=(), geolocation=(self)",
+          },
+          ...(process.env.NODE_ENV === "production"
+            ? [
+                {
+                  key: "Strict-Transport-Security",
+                  value: "max-age=31536000; includeSubDomains",
+                },
+              ]
+            : []),
+        ],
+      },
+    ]
+  },
+}
+
+export default nextConfig

apps/n1/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "n1",
+  "version": "0.1.0",
+  "private": true,
+  "scripts": {
+    "dev": "next dev --turbopack",
+    "build": "next build --turbopack",
+    "start": "next start",
+    "lint": "biome check",
+    "format": "biome format --write",
+    "generate:categories": "node scripts/generate-categories.mjs",
+    "validate:token-usage": "node scripts/validate-token-usage.mjs"
+  },
+  "dependencies": {
+    "@medusajs/js-sdk": "^2.10.3",
+    "@medusajs/types": "^2.10.3",
+    "@tanstack/react-form": "^1.27.4",
+    "@tanstack/react-query": "^5.90.2",
+    "@techsio/analytics": "workspace:*",
+    "@techsio/ui-kit": "workspace:*",
+    "next": "16.0.7",
+    "react": "19.2.0",
+    "react-dom": "19.2.0",
+    "tailwind-variants": "^3.1.1"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^2.3.7",
+    "@iconify/tailwind4": "^1.0.6",
+    "@tailwindcss/postcss": "^4",
+    "@tanstack/react-query-devtools": "^5.90.2",
+    "@types/node": "^20",
+    "@types/react": "19.2.2",
+    "@types/react-dom": "19.2.1",
+    "babel-plugin-react-compiler": "^1.0.0",
+    "dotenv": "^16.4.7",
+    "postcss": "^8.5.6",
+    "postcss-import": "^16.1.1",
+    "tailwindcss": "^4",
+    "tailwindcss-animate": "^1.0.7",
+    "typescript": "^5.9.3"
+  }
+}

apps/n1/postcss.config.mjs

@@ -0,0 +1,8 @@
+const config = {
+  plugins: {
+    "postcss-import": {},
+    "@tailwindcss/postcss": {},
+  },
+}
+
+export default config