create-edhor-stack 0.1.0

package/templates/apps/mobile/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@{{name}}/mobile",
+  "version": "1.0.0",
+  "private": true,
+  "main": "expo-router/entry",
+  "scripts": {
+    "dev": "expo start",
+    "android": "expo run:android",
+    "ios": "expo run:ios",
+    "build": "eas build"
+  },
+  "dependencies": {
+    "expo": "~54.0.0",
+    "expo-router": "~6.0.22",
+    "expo-status-bar": "~3.0.9",
+    "expo-linking": "~8.0.11",
+    "expo-constants": "~18.0.13",
+    "react": "19.1.0",
+    "react-native": "0.81.5",
+    "react-native-safe-area-context": "~5.6.0",
+    "react-native-screens": "~4.16.0",
+    "react-native-gesture-handler": "~2.28.0",
+    "react-native-reanimated": "~4.1.1",
+    "@tanstack/react-query": "^5.60.0",
+    "@tanstack/react-query-persist-client": "^5.60.0",
+    "@tanstack/query-async-storage-persister": "^5.60.0",
+    "@react-native-async-storage/async-storage": "^2.0.0",
+    "zustand": "^5.0.0",
+    "zod": "^3.24.0",
+    "@t3-oss/env-core": "^0.12.0",
+    "@shopify/flash-list": "2.0.2",
+    "lucide-react-native": "^0.460.0"
+  },
+  "devDependencies": {
+    "@babel/core": "^7.25.0",
+    "@types/react": "~19.1.10",
+    "typescript": "~5.9.2"
+  }
+}

package/templates/apps/mobile/src/api/client.ts

@@ -0,0 +1,51 @@
+import type { z } from 'zod';
+
+import { env } from '@/lib/env';
+
+/**
+ * Fetch with Zod validation - validates API responses at runtime.
+ *
+ * @example
+ * ```ts
+ * const user = await fetchValidated('/users/123', UserSchema);
+ * // user is typed as User and validated at runtime
+ * ```
+ */
+export async function fetchValidated<T>(
+  path: string,
+  schema: z.ZodType<T>,
+  options?: RequestInit
+): Promise<T> {
+  const url = path.startsWith('http') ? path : `${env.EXPO_PUBLIC_API_URL}${path}`;
+
+  const response = await fetch(url, {
+    ...options,
+    headers: {
+      'Content-Type': 'application/json',
+      ...options?.headers,
+    },
+  });
+
+  if (!response.ok) {
+    throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+  }
+
+  const data = await response.json();
+  return schema.parse(data);
+}
+
+/**
+ * POST with Zod validation
+ */
+export async function postValidated<T>(
+  path: string,
+  body: unknown,
+  schema: z.ZodType<T>,
+  options?: RequestInit
+): Promise<T> {
+  return fetchValidated(path, schema, {
+    ...options,
+    method: 'POST',
+    body: JSON.stringify(body),
+  });
+}

package/templates/apps/mobile/src/api/index.ts

@@ -0,0 +1,3 @@
+export * from './client';
+export * from './queries';
+export * from './schemas';

package/templates/apps/mobile/src/api/queries.ts

@@ -0,0 +1,24 @@
+import { queryOptions } from '@tanstack/react-query';
+
+import { fetchValidated } from './client';
+import { ItemSchema, PaginatedResponseSchema, UserSchema } from './schemas';
+
+// ============================================================================
+// QUERY OPTIONS - Replace with your actual queries
+// ============================================================================
+
+export const userQueryOptions = (userId: string) =>
+  queryOptions({
+    queryKey: ['user', userId],
+    queryFn: () => fetchValidated(`/users/${userId}`, UserSchema),
+  });
+
+export const itemsQueryOptions = (cursor?: string) =>
+  queryOptions({
+    queryKey: ['items', { cursor }],
+    queryFn: () =>
+      fetchValidated(
+        `/items${cursor ? `?cursor=${cursor}` : ''}`,
+        PaginatedResponseSchema(ItemSchema)
+      ),
+  });

package/templates/apps/mobile/src/api/schemas.ts

@@ -0,0 +1,32 @@
+import { z } from 'zod';
+
+// ============================================================================
+// EXAMPLE SCHEMAS - Replace with your actual API schemas
+// ============================================================================
+
+export const UserSchema = z.object({
+  id: z.string(),
+  email: z.string().email(),
+  name: z.string(),
+  avatar: z.string().url().optional(),
+  createdAt: z.string().datetime(),
+});
+
+export type User = z.infer<typeof UserSchema>;
+
+export const ItemSchema = z.object({
+  id: z.string(),
+  title: z.string(),
+  description: z.string().optional(),
+  createdAt: z.string().datetime(),
+  updatedAt: z.string().datetime(),
+});
+
+export type Item = z.infer<typeof ItemSchema>;
+
+export const PaginatedResponseSchema = <T extends z.ZodTypeAny>(itemSchema: T) =>
+  z.object({
+    items: z.array(itemSchema),
+    nextCursor: z.string().nullable(),
+    hasMore: z.boolean(),
+  });

package/templates/apps/mobile/src/lib/env.ts

@@ -0,0 +1,40 @@
+import { createEnv } from '@t3-oss/env-core';
+import { z } from 'zod';
+
+export const env = createEnv({
+  /**
+   * Server-side environment variables.
+   * These should only be used in API routes or server functions.
+   */
+  server: {
+    // API_SECRET: z.string().min(32),
+  },
+
+  /**
+   * Client-side environment variables (available everywhere).
+   * Must be prefixed with EXPO_PUBLIC_ in .env files.
+   */
+  clientPrefix: 'EXPO_PUBLIC_',
+  client: {
+    EXPO_PUBLIC_API_URL: z.string().url().default('https://api.example.com'),
+    // EXPO_PUBLIC_SENTRY_DSN: z.string().url().optional(),
+  },
+
+  /**
+   * Runtime environment - manually specify all variables.
+   */
+  runtimeEnv: {
+    EXPO_PUBLIC_API_URL: process.env.EXPO_PUBLIC_API_URL,
+    // Add all variables here
+  },
+
+  /**
+   * Treat empty strings as undefined.
+   */
+  emptyStringAsUndefined: true,
+
+  /**
+   * Skip validation during builds if needed.
+   */
+  skipValidation: process.env.SKIP_ENV_VALIDATION === 'true',
+});

package/templates/apps/mobile/src/lib/query-client.ts

@@ -0,0 +1,28 @@
+import AsyncStorage from '@react-native-async-storage/async-storage';
+import { createAsyncStoragePersister } from '@tanstack/query-async-storage-persister';
+import { QueryClient } from '@tanstack/react-query';
+
+export const queryClient = new QueryClient({
+  defaultOptions: {
+    queries: {
+      // Keep cached data for 7 days (offline support)
+      gcTime: 1000 * 60 * 60 * 24 * 7,
+      // Data considered fresh for 5 minutes
+      staleTime: 1000 * 60 * 5,
+      // Try cache first, then network
+      networkMode: 'offlineFirst',
+      // Retry with exponential backoff
+      retry: 3,
+      retryDelay: (attemptIndex) => Math.min(1000 * 2 ** attemptIndex, 30000),
+    },
+    mutations: {
+      networkMode: 'offlineFirst',
+    },
+  },
+});
+
+// Persist to AsyncStorage for true offline support
+export const persister = createAsyncStoragePersister({
+  storage: AsyncStorage,
+  key: 'REACT_QUERY_OFFLINE_CACHE',
+});

package/templates/apps/mobile/src/lib/result.ts

@@ -0,0 +1,45 @@
+/**
+ * Result type for explicit error handling without try-catch everywhere.
+ *
+ * @example
+ * ```ts
+ * async function fetchUser(id: string): Promise<Result<User, string>> {
+ *   try {
+ *     const user = await api.getUser(id);
+ *     return ok(user);
+ *   } catch (e) {
+ *     return err(e instanceof Error ? e.message : 'Unknown error');
+ *   }
+ * }
+ *
+ * // Usage
+ * const result = await fetchUser('123');
+ * if (!result.ok) {
+ *   showToast(result.error);
+ *   return;
+ * }
+ * const user = result.value;
+ * ```
+ */
+export type Result<T, E = Error> = { ok: true; value: T } | { ok: false; error: E };
+
+export const ok = <T>(value: T): Result<T, never> => ({ ok: true, value });
+export const err = <E>(error: E): Result<never, E> => ({ ok: false, error });
+
+/**
+ * Unwrap a Result, throwing if it's an error.
+ * Only use this when you're certain the result is ok.
+ */
+export function unwrap<T, E>(result: Result<T, E>): T {
+  if (!result.ok) {
+    throw result.error;
+  }
+  return result.value;
+}
+
+/**
+ * Unwrap a Result with a default value for errors.
+ */
+export function unwrapOr<T, E>(result: Result<T, E>, defaultValue: T): T {
+  return result.ok ? result.value : defaultValue;
+}

package/templates/apps/mobile/src/lib/store.ts

@@ -0,0 +1,63 @@
+import AsyncStorage from '@react-native-async-storage/async-storage';
+import { create } from 'zustand';
+import { createJSONStorage, persist } from 'zustand/middleware';
+
+// ============================================================================
+// APP STORE
+// ============================================================================
+
+interface AppState {
+  fontSize: 'small' | 'medium' | 'large';
+  theme: 'light' | 'dark' | 'system';
+  setFontSize: (size: AppState['fontSize']) => void;
+  setTheme: (theme: AppState['theme']) => void;
+}
+
+export const useAppStore = create<AppState>()(
+  persist(
+    (set) => ({
+      fontSize: 'medium',
+      theme: 'system',
+      setFontSize: (fontSize) => set({ fontSize }),
+      setTheme: (theme) => set({ theme }),
+    }),
+    {
+      name: 'app-storage',
+      storage: createJSONStorage(() => AsyncStorage),
+    }
+  )
+);
+
+// ============================================================================
+// SEARCH STORE
+// ============================================================================
+
+interface SearchState {
+  query: string;
+  recentSearches: string[];
+  setQuery: (query: string) => void;
+  addRecentSearch: (search: string) => void;
+  clearRecentSearches: () => void;
+}
+
+export const useSearchStore = create<SearchState>()(
+  persist(
+    (set) => ({
+      query: '',
+      recentSearches: [],
+      setQuery: (query) => set({ query }),
+      addRecentSearch: (search) =>
+        set((state) => ({
+          recentSearches: [search, ...state.recentSearches.filter((s) => s !== search)].slice(
+            0,
+            10
+          ),
+        })),
+      clearRecentSearches: () => set({ recentSearches: [] }),
+    }),
+    {
+      name: 'search-storage',
+      storage: createJSONStorage(() => AsyncStorage),
+    }
+  )
+);

package/templates/apps/mobile/tsconfig.json

@@ -0,0 +1,10 @@
+{
+  "extends": "expo/tsconfig.base",
+  "compilerOptions": {
+    "strict": true,
+    "paths": {
+      "@/*": ["./src/*"]
+    }
+  },
+  "include": ["**/*.ts", "**/*.tsx", ".expo/types/**/*.ts", "expo-env.d.ts"]
+}

package/templates/apps/web/.env.example

@@ -0,0 +1,11 @@
+# Environment Variables
+# Copy this file to .env.local and fill in the values
+
+# Server-side only (not exposed to client)
+NODE_ENV=development
+# DATABASE_URL=postgresql://user:password@localhost:5432/db
+# API_SECRET=your-secret-key-at-least-32-characters
+
+# Client-side (prefixed with VITE_)
+VITE_APP_URL=http://localhost:3000
+# VITE_PUBLIC_API_URL=https://api.example.com

package/templates/apps/web/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "@{{name}}/web",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "vite",
+    "build": "vite build",
+    "start": "node .output/server/index.mjs"
+  },
+  "dependencies": {
+    "@tanstack/react-router": "^1.154.14",
+    "@tanstack/react-start": "^1.154.14",
+    "@tanstack/react-query": "^5.60.0",
+    "@t3-oss/env-core": "^0.12.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "zod": "^3.24.0",
+    "lucide-react": "^0.460.0"
+  },
+  "devDependencies": {
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.0.0",
+    "@vitejs/plugin-react": "^4.4.1",
+    "vite": "^6.3.0",
+    "vite-tsconfig-paths": "^5.1.4",
+    "tailwindcss": "^4.0.0",
+    "@tailwindcss/vite": "^4.0.0"
+  }
+}

package/templates/apps/web/src/lib/env.ts

@@ -0,0 +1,52 @@
+import { createEnv } from '@t3-oss/env-core';
+import { z } from 'zod';
+
+export const env = createEnv({
+  /**
+   * Server-side environment variables (not available on client).
+   * Will throw if accessed on the client.
+   */
+  server: {
+    NODE_ENV: z.enum(['development', 'production', 'test']).default('development'),
+    // DATABASE_URL: z.string().url(),
+    // API_SECRET: z.string().min(32),
+  },
+
+  /**
+   * Client-side environment variables (available everywhere).
+   * Must be prefixed with VITE_ in .env files.
+   */
+  clientPrefix: 'VITE_',
+  client: {
+    VITE_APP_URL: z.string().url().default('http://localhost:3000'),
+    // VITE_PUBLIC_API_URL: z.string().url(),
+  },
+
+  /**
+   * Shared variables (available on both client and server).
+   */
+  shared: {
+    // NODE_ENV is commonly shared
+  },
+
+  /**
+   * Runtime environment - manually specify all variables.
+   * Required for bundlers that don't automatically inline process.env.
+   */
+  runtimeEnv: {
+    NODE_ENV: process.env.NODE_ENV,
+    VITE_APP_URL: process.env.VITE_APP_URL,
+    // Add all variables here
+  },
+
+  /**
+   * Treat empty strings as undefined.
+   * Useful for optional variables.
+   */
+  emptyStringAsUndefined: true,
+
+  /**
+   * Skip validation in certain environments.
+   */
+  skipValidation: process.env.SKIP_ENV_VALIDATION === 'true',
+});

package/templates/apps/web/src/lib/queries.ts

@@ -0,0 +1,27 @@
+import { queryOptions } from '@tanstack/react-query';
+
+// ============================================================================
+// EXAMPLE QUERY OPTIONS - Replace with your actual queries
+// ============================================================================
+
+export const exampleQueryOptions = queryOptions({
+  queryKey: ['example'],
+  queryFn: async () => {
+    // Replace with your actual API call
+    return { message: 'Hello from TanStack Query!' };
+  },
+  staleTime: 1000 * 60 * 5, // 5 minutes
+});
+
+/**
+ * Query options factory pattern for dynamic queries
+ */
+export const itemQueryOptions = (id: string) =>
+  queryOptions({
+    queryKey: ['items', id],
+    queryFn: async () => {
+      const response = await fetch(`/api/items/${id}`);
+      if (!response.ok) throw new Error('Failed to fetch item');
+      return response.json();
+    },
+  });

package/templates/apps/web/src/lib/query-client.ts

@@ -0,0 +1,11 @@
+import { QueryClient } from '@tanstack/react-query';
+
+export const queryClient = new QueryClient({
+  defaultOptions: {
+    queries: {
+      staleTime: 1000 * 60 * 5, // 5 minutes
+      retry: 3,
+      retryDelay: (attemptIndex) => Math.min(1000 * 2 ** attemptIndex, 30000),
+    },
+  },
+});

package/templates/apps/web/src/router.tsx

@@ -0,0 +1,17 @@
+import { createRouter } from '@tanstack/react-router';
+import { routeTree } from './routeTree.gen';
+
+export function getRouter() {
+  const router = createRouter({
+    routeTree,
+    defaultPreload: 'intent',
+    scrollRestoration: true,
+  });
+  return router;
+}
+
+declare module '@tanstack/react-router' {
+  interface Register {
+    router: ReturnType<typeof getRouter>;
+  }
+}

package/templates/apps/web/src/routes/__root.tsx

@@ -0,0 +1,32 @@
+import { QueryClientProvider } from '@tanstack/react-query';
+import { createRootRouteWithContext, Outlet } from '@tanstack/react-router';
+
+import { queryClient } from '../lib/query-client';
+import '../styles.css';
+
+import type { QueryClient } from '@tanstack/react-query';
+
+export interface RouterContext {
+  queryClient: QueryClient;
+}
+
+export const Route = createRootRouteWithContext<RouterContext>()({
+  component: RootLayout,
+});
+
+function RootLayout() {
+  return (
+    <QueryClientProvider client={queryClient}>
+      <html lang="en">
+        <head>
+          <meta charSet="UTF-8" />
+          <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+          <title>{{name}}</title>
+        </head>
+        <body className="min-h-screen bg-background text-foreground antialiased">
+          <Outlet />
+        </body>
+      </html>
+    </QueryClientProvider>
+  );
+}

package/templates/apps/web/src/routes/index.tsx

@@ -0,0 +1,16 @@
+import { createFileRoute } from '@tanstack/react-router';
+
+export const Route = createFileRoute('/')({
+  component: Home,
+});
+
+function Home() {
+  return (
+    <main className="flex min-h-screen flex-col items-center justify-center p-8">
+      <h1 className="text-4xl font-bold tracking-tight">Welcome to {{name}}</h1>
+      <p className="mt-4 text-muted-foreground">
+        Edit <code className="rounded bg-muted px-1.5 py-0.5 font-mono text-sm">src/routes/index.tsx</code> to get started.
+      </p>
+    </main>
+  );
+}

package/templates/apps/web/src/styles.css

@@ -0,0 +1,26 @@
+@import 'tailwindcss';
+
+@theme {
+  --color-background: oklch(1 0 0);
+  --color-foreground: oklch(0.1 0 0);
+  --color-primary: oklch(0.5 0.2 250);
+  --color-primary-foreground: oklch(1 0 0);
+  --color-muted: oklch(0.95 0 0);
+  --color-muted-foreground: oklch(0.4 0 0);
+  --color-border: oklch(0.9 0 0);
+  --font-sans: 'Inter', system-ui, sans-serif;
+}
+
+@media (prefers-color-scheme: dark) {
+  @theme {
+    --color-background: oklch(0.1 0 0);
+    --color-foreground: oklch(0.95 0 0);
+    --color-muted: oklch(0.2 0 0);
+    --color-muted-foreground: oklch(0.6 0 0);
+    --color-border: oklch(0.25 0 0);
+  }
+}
+
+body {
+  font-family: var(--font-sans);
+}

package/templates/apps/web/tsconfig.json

@@ -0,0 +1,10 @@
+{
+  "extends": "../../tsconfig.json",
+  "compilerOptions": {
+    "jsx": "react-jsx",
+    "paths": {
+      "@/*": ["./src/*"]
+    }
+  },
+  "include": ["src"]
+}

package/templates/apps/web/vite.config.ts

@@ -0,0 +1,21 @@
+import { tanstackStart } from '@tanstack/react-start/plugin/vite';
+import tailwindcss from '@tailwindcss/vite';
+import viteReact from '@vitejs/plugin-react';
+import { defineConfig } from 'vite';
+import tsConfigPaths from 'vite-tsconfig-paths';
+
+export default defineConfig({
+  server: {
+    port: 3000,
+  },
+  plugins: [
+    tailwindcss(),
+    tsConfigPaths({
+      projects: ['./tsconfig.json'],
+    }),
+    tanstackStart({
+      srcDirectory: 'src',
+    }),
+    viteReact(),
+  ],
+});

package/templates/base/.claude/settings.json

@@ -0,0 +1,33 @@
+{
+  "$schema": "https://claude.ai/schemas/claude-code-settings.json",
+  "permissions": {
+    "allow": [
+      "Bash(bun *)",
+      "Bash(turbo *)",
+      "Bash(git status)",
+      "Bash(git diff*)",
+      "Bash(git log*)",
+      "Bash(git add*)",
+      "Bash(git commit*)",
+      "Bash(git branch*)",
+      "Bash(git checkout*)",
+      "Bash(git switch*)",
+      "Bash(npx expo*)",
+      "Bash(eas *)"
+    ],
+    "deny": [
+      "Bash(rm -rf /)",
+      "Bash(git push --force)",
+      "Bash(git reset --hard)"
+    ]
+  },
+  "instructions": [
+    "Always use Biome for linting: `bun check` not eslint",
+    "Use @/ import alias for src/ paths",
+    "Follow existing patterns in the codebase",
+    "Write tests before implementation (TDD)",
+    "Use Zustand selectors, never destructure entire store",
+    "Validate all API responses with Zod schemas",
+    "Keep commits small and focused"
+  ]
+}