🔀 merge pull request #364 from onRuntime/antoinekm/claude

📝 add claude.md

Author: antoinekm

CLAUDE.md

@@ -0,0 +1,70 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Commands
+
+```bash
+# Development
+pnpm dev          # Start dev server with Turbopack
+pnpm build        # Build all packages
+pnpm type-check   # Run TypeScript checks
+
+# Run commands for specific app
+pnpm --filter @onruntime/web dev
+pnpm --filter @onruntime/web build
+```
+
+## Architecture
+
+### Monorepo Structure (Turborepo + pnpm workspaces)
+
+```
+/
+├── apps/
+│   └── web/              # Next.js 16 website (@onruntime/web)
+├── packages/             # Shared packages (future)
+├── turbo.json            # Turborepo configuration
+└── pnpm-workspace.yaml   # pnpm workspace config
+```
+
+### Web App Structure (`apps/web/src/`)
+
+- **app/**: Next.js App Router pages and API routes
+- **components/**: React components (ui/, layout/, marketing/)
+- **services/**: External API clients with lazy initialization
+- **constants/**: Static data (projects, agencies, services, team members)
+- **content/**: MDX content (glossary, legal pages)
+- **lib/**: Utilities and helpers
+- **types/**: TypeScript type definitions
+
+### Key Patterns
+
+**Services**: Use lazy initialization for external API clients to avoid build failures when env vars are missing in CI:
+```typescript
+// services/email.ts - Proxy pattern for lazy init
+export const resend = new Proxy({} as Resend, {
+  get(_, prop) {
+    if (!instance) {
+      instance = new Resend(env.RESEND_API_KEY);
+    }
+    return instance[prop as keyof Resend];
+  },
+});
+
+// services/join.ts - Client pattern
+export const joinClient = {
+  async jobs() { ... },
+  async job(id) { ... },
+};
+```
+
+**Environment Variables**: Managed via `@t3-oss/env-nextjs` in `env.ts`. Validation is skipped in CI (`skipValidation: !!process.env.CI`).
+
+**API Routes**: Use `unstable_cache` from Next.js for caching external API responses.
+
+## Environment Variables
+
+Required for runtime (optional for build):
+- `RESEND_API_KEY`: Email sending via Resend
+- `JOIN_API_KEY`: Job listings from join.com API

apps/web/env.mjs apps/web/env.tsapps/web/env.mjs renamed to apps/web/env.ts

@@ -0,0 +1,44 @@
+import createMDX from "@next/mdx";
+import type { NextConfig } from "next";
+import "./env";
+
+const nextConfig: NextConfig = {
+  pageExtensions: ["ts", "tsx", "js", "jsx", "md", "mdx"],
+  reactStrictMode: process.env.NODE_ENV === "development",
+  transpilePackages: ["next-seo"],
+  env: {
+    NEXT_PUBLIC_NODE_ENV: process.env.NODE_ENV,
+  },
+  webpack(config) {
+    config.module.rules.push({
+      test: /\.svg$/i,
+      use: ["@svgr/webpack"],
+    });
+    return config;
+  },
+  async redirects() {
+    return [
+      {
+        source: "/projects/instagram-dark/welcome",
+        destination: "/projects/dark-theme-instagram",
+        permanent: true,
+      },
+      {
+        source: "/projects/instagram-dark",
+        destination: "/projects/dark-theme-instagram",
+        permanent: true,
+      },
+      {
+        source: "/about",
+        destination: "/npo",
+        permanent: false,
+      },
+    ];
+  },
+};
+
+const withMDX = createMDX({
+  extension: /\.mdx?$/,
+});
+
+export default withMDX(nextConfig);

apps/web/next.config.mjs

@@ -3,7 +3,7 @@ import { constructMetadata } from "@/lib/utils/metadata";
 import JobDetailPage from "@/screens/marketing/careers/job-details";
 import { JobPosting } from "@/types/job";
 import { Metadata } from "next";
-import { env } from "env.mjs";
+import { env } from "env";
 
 async function getJobById(id: string): Promise<JobPosting | null> {
   try {

apps/web/next.config.ts

@@ -1,4 +1,4 @@
-import { env } from "env.mjs";
+import { env } from "env";
 import { Resend } from "resend";
 
 let instance: Resend | null = null;

apps/web/src/app/careers/[id]/page.tsx

@@ -1,5 +1,5 @@
 import { z } from "zod";
-import { env } from "env.mjs";
+import { env } from "env";
 
 const JOIN_API_BASE_URL = "https://api.join.com/v2";