create-lightning-scaffold 1.0.0 → 1.0.2

package/README.md

@@ -1,6 +1,7 @@
 # create-lightning-scaffold
+<img width="1826" height="1183" alt="Screenshot 2026-01-12 at 22 18 56" src="https://github.com/user-attachments/assets/c34c35d4-1d18-49a4-8024-2d55f774af2e" />
 
-CLI to scaffold projects with LazorKit SDK integration. Generate React Native (Expo) or Next.js projects with passkey authentication, gasless transactions, and biometric onboarding built-in.
+CLI to scaffold Solana apps with LazorKit SDK. Generate React Native (Expo) or Next.js projects with passkey authentication, gasless transactions, and a ready-to-use swap interface.
 
 ## Quick Start
 
@@ -8,24 +9,29 @@ CLI to scaffold projects with LazorKit SDK integration. Generate React Native (E
 npx create-lightning-scaffold
 ```
 
-## Features
+## What You Get
 
-- 🚀 **5 Presets**: Mobile App, Web App, Full-Stack Mobile, Full-Stack Web, Monorepo
-- 🔐 **LazorKit SDK**: Passkey auth, gasless transactions, smart wallets
-- 📱 **React Native + Expo**: Official `create-expo-app` under the hood
-- 🌐 **Next.js**: Official `create-next-app` under the hood
-- 🎨 **Styling**: TailwindCSS (web) / NativeWind (mobile)
-- 📦 **State**: Zustand or Redux Toolkit
-- 🗄️ **Backend**: Supabase or Firebase integration
-- 📦 **Package Managers**: npm, pnpm, yarn, bun
+Every generated project includes:
 
-## Included Examples
+- **Passkey Onboarding** - Create wallets with Face ID/Touch ID, no seed phrases
+- **Token Swap UI** - Real swap interface powered by Jupiter aggregator (SOL ↔ USDC)
+- **Balance Display** - Real-time token balances with Max button
+- **Transaction History** - View past transactions with Solscan links
+- **Recovery & Backup** - Add backup passkeys from other devices
+- **Message Signing** - Verify wallet ownership with `signMessage`
+- **Gasless Transactions** - Users don't pay gas fees (paymaster sponsored)
+- **Smart Wallets** - LazorKit PDA-based accounts with recovery options
 
-Every generated project includes 3 working LazorKit examples:
+## Features
 
-1. **Passkey Login** - WebAuthn-based authentication with smart wallet
-2. **Gasless Transfer** - Send SOL without paying gas fees
-3. **Biometric Onboarding** - Mobile-first onboarding with FaceID/TouchID
+- 🚀 **5 Presets**: Mobile App, Web App, Full-Stack Mobile, Full-Stack Web, Monorepo
+- 🔐 **LazorKit SDK**: Official `@lazorkit/wallet` (web) and `@lazorkit/wallet-mobile-adapter` (mobile)
+- 🔄 **Jupiter Integration**: Real-time quotes and swaps via Jupiter aggregator API
+- 📱 **React Native + Expo**: Native passkey support with `expo-web-browser`
+- 🌐 **Next.js + Vite**: Both frameworks supported with proper polyfills
+- 🎨 **Styling**: TailwindCSS or pure CSS/StyleSheet (your choice)
+- 📦 **State**: Zustand or Redux Toolkit
+- 🗄️ **Backend**: Supabase, Firebase, or NestJS integration
 
 ## Usage
 
@@ -36,29 +42,105 @@ npx create-lightning-scaffold
 # You'll be prompted for:
 # - Project name
 # - Preset (Mobile, Web, Full-Stack, Monorepo)
-# - Customization options (styling, state, components, backend)
+# - Web framework (Next.js or Vite)
+# - Styling preference (tailwind or none)
+# - State management
 # - Package manager
 ```
 
 ## Presets
 
-| Preset | Description | Structure |
-|--------|-------------|-----------|
-| Mobile App | React Native + Expo | Flat |
-| Web App | Next.js | Flat |
-| Full-Stack Mobile | React Native + Backend | Monorepo |
-| Full-Stack Web | Next.js + Backend | Monorepo |
-| Monorepo | Mobile + Web + Backend | Monorepo |
+| Preset | Description | SDK |
+|--------|-------------|-----|
+| Mobile App | React Native + Expo | `@lazorkit/wallet-mobile-adapter` |
+| Web App | Next.js or Vite | `@lazorkit/wallet` |
+| Full-Stack Mobile | React Native + Backend | `@lazorkit/wallet-mobile-adapter` |
+| Full-Stack Web | Next.js/Vite + Backend | `@lazorkit/wallet` |
+| Monorepo | Mobile + Web + Backend | Both |
 
 ## Configuration
 
-After scaffolding, copy `.env.example` to `.env` and add your LazorKit API key:
+After scaffolding, copy `.env.example` to `.env`:
 
 ```bash
 cp .env.example .env
 ```
 
-Get your API key from [portal.lazor.sh](https://portal.lazor.sh).
+Default config uses Devnet. For production, get your API key from [portal.lazor.sh](https://portal.lazor.sh).
+
+## SDK Integration
+
+### Web (Next.js / Vite)
+
+Uses `@lazorkit/wallet` with `LazorkitProvider`:
+
+```tsx
+import { LazorkitProvider, useWallet } from '@lazorkit/wallet';
+
+// Provider setup
+<LazorkitProvider
+  rpcUrl="https://api.devnet.solana.com"
+  portalUrl="https://portal.lazor.sh"
+  paymasterConfig={{ paymasterUrl: "https://kora.devnet.lazorkit.com" }}
+>
+  {children}
+</LazorkitProvider>
+
+// In components
+const { connect, disconnect, signAndSendTransaction, signMessage, wallet } = useWallet();
+
+// Connect with passkey
+await connect();
+
+// Sign a message
+const { signature } = await signMessage("Verify ownership");
+
+// Send gasless transaction
+const sig = await signAndSendTransaction({
+  instructions: [instruction],
+  transactionOptions: { feeToken: 'USDC' }
+});
+```
+
+### Mobile (Expo)
+
+Uses `@lazorkit/wallet-mobile-adapter` with `LazorKitProvider`:
+
+```tsx
+import { LazorKitProvider, useWallet } from '@lazorkit/wallet-mobile-adapter';
+
+// Provider setup
+<LazorKitProvider
+  rpcUrl="https://api.devnet.solana.com"
+  portalUrl="https://portal.lazor.sh"
+  configPaymaster={{ paymasterUrl: "https://kora.devnet.lazorkit.com" }}
+>
+  {children}
+</LazorKitProvider>
+
+// In components - requires redirectUrl for mobile
+const { connect, signAndSendTransaction, signMessage, wallet } = useWallet();
+
+await connect({ redirectUrl: 'myapp://callback' });
+await signMessage("Hello", { redirectUrl: 'myapp://callback' });
+```
+
+## Jupiter Swap Integration
+
+The generated swap UI uses Jupiter's aggregator API for real-time quotes:
+
+```tsx
+// Get quote
+const quote = await fetch(
+  `https://api.jup.ag/swap/v1/quote?inputMint=${SOL}&outputMint=${USDC}&amount=${amount}&slippageBps=50`
+).then(r => r.json());
+
+// Build swap transaction
+const { swapTransaction } = await fetch('https://api.jup.ag/swap/v1/swap', {
+  method: 'POST',
+  body: JSON.stringify({ quoteResponse: quote, userPublicKey: wallet })
+}).then(r => r.json());
+```
 
 ## License
 

package/dist/index.js

@@ -14,12 +14,12 @@ import pc from "picocolors";
 // src/utils/types.ts
 var PRESET_INFO = {
   mobile: { label: "Mobile App", hint: "React Native + Expo", platforms: ["mobile"] },
-  web: { label: "Web App", hint: "Next.js", platforms: ["web"] },
+  web: { label: "Web App", hint: "Next.js or Vite", platforms: ["web"] },
   "fullstack-mobile": { label: "Full-Stack Mobile", hint: "React Native + Backend", platforms: ["mobile"] },
-  "fullstack-web": { label: "Full-Stack Web", hint: "Next.js + Backend", platforms: ["web"] },
+  "fullstack-web": { label: "Full-Stack Web", hint: "Web + Backend", platforms: ["web"] },
   monorepo: { label: "Monorepo", hint: "Mobile + Web + Backend", platforms: ["mobile", "web"] }
 };
-function getCompatibleOptions(preset) {
+function getCompatibleOptions(preset, webFramework) {
   const info = PRESET_INFO[preset];
   const hasMobile = info.platforms.includes("mobile");
   const hasWeb = info.platforms.includes("web");
@@ -27,13 +27,20 @@ function getCompatibleOptions(preset) {
   return {
     styling: hasMobile ? ["nativewind", "none"] : ["tailwind", "none"],
     components: hasMobile ? ["nativewind-ui", "none"] : ["shadcn", "none"],
-    backend: hasBackend ? ["supabase", "firebase"] : ["none"],
-    state: ["zustand", "redux"]
+    backend: hasBackend ? ["nestjs-postgres", "nestjs-mongodb", "supabase", "firebase"] : ["none"],
+    state: ["zustand", "redux"],
+    animation: hasMobile ? ["reanimated", "moti", "none"] : ["framer", "none"]
   };
 }
 function isMonorepoPreset(preset) {
   return preset === "fullstack-mobile" || preset === "fullstack-web" || preset === "monorepo";
 }
+function hasWebPlatform(preset) {
+  return PRESET_INFO[preset].platforms.includes("web");
+}
+function hasMobilePlatform(preset) {
+  return PRESET_INFO[preset].platforms.includes("mobile");
+}
 
 // src/utils/helpers.ts
 import fs from "fs-extra";
@@ -68,16 +75,45 @@ async function runPrompts() {
     }))
   });
   if (p.isCancel(preset)) return null;
-  const options = getCompatibleOptions(preset);
+  const showWebFramework = hasWebPlatform(preset);
+  const showMobileOptions = hasMobilePlatform(preset);
+  const hasBackend = preset.includes("fullstack") || preset === "monorepo";
+  let webFramework = "nextjs";
+  if (showWebFramework) {
+    const webChoice = await p.select({
+      message: "Web framework:",
+      options: [
+        { value: "nextjs", label: "Next.js", hint: "Full-featured React framework" },
+        { value: "vite", label: "Vite", hint: "Fast, lightweight SPA" }
+      ]
+    });
+    if (p.isCancel(webChoice)) return null;
+    webFramework = webChoice;
+  }
+  let backend = "none";
+  if (hasBackend) {
+    const backendChoice = await p.select({
+      message: "Backend:",
+      options: [
+        { value: "nestjs-postgres", label: "NestJS + PostgreSQL", hint: "Prisma ORM" },
+        { value: "nestjs-mongodb", label: "NestJS + MongoDB", hint: "Mongoose ODM" },
+        { value: "supabase", label: "Supabase", hint: "BaaS with Postgres" },
+        { value: "firebase", label: "Firebase", hint: "Google BaaS" }
+      ]
+    });
+    if (p.isCancel(backendChoice)) return null;
+    backend = backendChoice;
+  }
+  const options = getCompatibleOptions(preset, webFramework);
   const customize = await p.confirm({
-    message: "Customize options?",
+    message: "Customize styling, state & animations?",
     initialValue: false
   });
   if (p.isCancel(customize)) return null;
   let styling = options.styling[0];
   let components = options.components[0];
   let state = "zustand";
-  let backend = options.backend[0];
+  let animation = "none";
   if (customize) {
     const stylingChoice = await p.select({
       message: "Styling:",
@@ -88,8 +124,8 @@ async function runPrompts() {
     const stateChoice = await p.select({
       message: "State management:",
       options: [
-        { value: "zustand", label: "Zustand" },
-        { value: "redux", label: "Redux Toolkit" }
+        { value: "zustand", label: "Zustand", hint: "Simple, lightweight" },
+        { value: "redux", label: "Redux Toolkit", hint: "Full-featured" }
       ]
     });
     if (p.isCancel(stateChoice)) return null;
@@ -100,17 +136,25 @@ async function runPrompts() {
     });
     if (p.isCancel(componentsChoice)) return null;
     components = componentsChoice;
-    if (options.backend[0] !== "none") {
-      const backendChoice = await p.select({
-        message: "Backend:",
-        options: [
-          { value: "supabase", label: "Supabase" },
-          { value: "firebase", label: "Firebase" }
-        ]
-      });
-      if (p.isCancel(backendChoice)) return null;
-      backend = backendChoice;
-    }
+    const animationChoice = await p.select({
+      message: "Animations:",
+      options: options.animation.map((v) => ({
+        value: v,
+        label: v === "none" ? "None" : v === "reanimated" ? "React Native Reanimated" : v === "framer" ? "Framer Motion" : "Moti",
+        hint: v === "moti" ? "Cross-platform, uses Reanimated" : void 0
+      }))
+    });
+    if (p.isCancel(animationChoice)) return null;
+    animation = animationChoice;
+  }
+  let eas = false;
+  if (showMobileOptions) {
+    const easChoice = await p.confirm({
+      message: "Setup EAS Build for app store deployment?",
+      initialValue: true
+    });
+    if (p.isCancel(easChoice)) return null;
+    eas = easChoice;
   }
   const packageManager = await p.select({
     message: "Package manager:",
@@ -130,10 +174,13 @@ async function runPrompts() {
   return {
     name,
     preset,
+    webFramework,
     backend,
     styling,
     state,
     components,
+    animation,
+    eas,
     packageManager,
     gitInit
   };
@@ -148,38 +195,62 @@ async function scaffold(config) {
   const templatesDir = getTemplatesDir();
   const isMonorepo = isMonorepoPreset(config.preset);
   const platforms = PRESET_INFO[config.preset].platforms;
-  await fs2.ensureDir(targetDir);
   if (isMonorepo) {
+    await fs2.ensureDir(targetDir);
     await setupMonorepo(targetDir, config);
     if (platforms.includes("mobile")) {
-      await copyTemplate(path2.join(templatesDir, "mobile"), path2.join(targetDir, "apps/mobile"), config);
+      await scaffoldMobile(path2.join(targetDir, "apps"), "mobile", config);
+      if (config.eas) await addEasConfig(path2.join(targetDir, "apps/mobile"), config);
     }
     if (platforms.includes("web")) {
-      await copyTemplate(path2.join(templatesDir, "web"), path2.join(targetDir, "apps/web"), config);
+      await scaffoldWeb(path2.join(targetDir, "apps"), "web", config);
     }
     if (config.backend !== "none") {
-      await fs2.ensureDir(path2.join(targetDir, "packages/backend"));
-      await copyTemplate(path2.join(templatesDir, "backend", config.backend), path2.join(targetDir, "packages/backend"), config);
+      await scaffoldBackend(path2.join(targetDir, "packages"), "backend", config);
     }
   } else {
-    const platformTemplate = platforms[0] === "mobile" ? "mobile" : "web";
-    await copyTemplate(path2.join(templatesDir, platformTemplate), targetDir, config);
+    if (platforms[0] === "mobile") {
+      await scaffoldMobile(process.cwd(), config.name, config);
+      if (config.eas) await addEasConfig(targetDir, config);
+    } else {
+      await scaffoldWeb(process.cwd(), config.name, config);
+    }
   }
   const appDir = isMonorepo ? path2.join(targetDir, platforms[0] === "mobile" ? "apps/mobile" : "apps/web") : targetDir;
-  await addStyling(appDir, config);
-  await addStateManagement(appDir, config);
-  await addComponents(appDir, config);
-  await addExamples(appDir, platforms[0], config);
+  const platform = platforms[0];
+  await addDependencies(appDir, platform, config);
+  await copyTemplate(path2.join(templatesDir, "state", config.state), path2.join(appDir, "lib/store"), config);
+  if (config.components !== "none") {
+    await copyTemplate(path2.join(templatesDir, "components", config.components), path2.join(appDir, "components/ui"), config);
+  }
+  if (config.backend !== "none") {
+    await copyTemplate(path2.join(templatesDir, "backend", config.backend), path2.join(appDir, "lib/backend"), config);
+    await copyTemplate(path2.join(templatesDir, "lib"), path2.join(appDir, "lib"), config);
+  }
   await copyTemplate(path2.join(templatesDir, "base"), targetDir, config);
   return targetDir;
 }
+async function scaffoldMobile(cwd, name, config) {
+  const templatesDir = getTemplatesDir();
+  await copyTemplate(path2.join(templatesDir, "mobile"), path2.join(cwd, name), config);
+}
+async function scaffoldWeb(cwd, name, config) {
+  const templatesDir = getTemplatesDir();
+  const templateName = config.webFramework === "vite" ? "vite" : "web";
+  await copyTemplate(path2.join(templatesDir, templateName), path2.join(cwd, name), config);
+}
+async function scaffoldBackend(cwd, name, config) {
+  const templatesDir = getTemplatesDir();
+  await copyTemplate(path2.join(templatesDir, "backend", config.backend), path2.join(cwd, name), config);
+}
 async function setupMonorepo(targetDir, config) {
   const pkg = {
     name: config.name,
     private: true,
     scripts: {
-      dev: "echo 'Run dev in apps/*'",
-      build: "echo 'Run build in apps/*'"
+      "dev:mobile": "cd apps/mobile && npm run start",
+      "dev:web": "cd apps/web && npm run dev",
+      "dev:backend": "cd packages/backend && npm run start:dev"
     }
   };
   if (config.packageManager === "pnpm") {
@@ -191,52 +262,80 @@ async function setupMonorepo(targetDir, config) {
   await fs2.ensureDir(path2.join(targetDir, "apps"));
   await fs2.ensureDir(path2.join(targetDir, "packages"));
 }
-async function addStyling(appDir, config) {
-  if (config.styling === "none") return;
+async function addDependencies(appDir, platform, config) {
   const pkgPath = path2.join(appDir, "package.json");
   if (!await fs2.pathExists(pkgPath)) return;
   const pkg = await fs2.readJson(pkgPath);
   pkg.dependencies = pkg.dependencies || {};
   pkg.devDependencies = pkg.devDependencies || {};
-  if (config.styling === "nativewind") {
-    pkg.dependencies["nativewind"] = "^4.0.0";
-    pkg.devDependencies["tailwindcss"] = "^3.4.0";
-    const templatesDir = getTemplatesDir();
-    await copyTemplate(path2.join(templatesDir, "styling", "nativewind"), appDir, config);
-  }
-  await fs2.writeJson(pkgPath, pkg, { spaces: 2 });
-}
-async function addStateManagement(appDir, config) {
-  const pkgPath = path2.join(appDir, "package.json");
-  if (!await fs2.pathExists(pkgPath)) return;
-  const pkg = await fs2.readJson(pkgPath);
-  pkg.dependencies = pkg.dependencies || {};
   if (config.state === "zustand") {
     pkg.dependencies["zustand"] = "^4.5.0";
   } else {
     pkg.dependencies["@reduxjs/toolkit"] = "^2.0.0";
     pkg.dependencies["react-redux"] = "^9.0.0";
   }
+  if (config.animation === "reanimated") {
+    pkg.dependencies["react-native-reanimated"] = "^3.10.0";
+    pkg.dependencies["react-native-gesture-handler"] = "^2.16.0";
+  } else if (config.animation === "moti") {
+    pkg.dependencies["moti"] = "^0.29.0";
+    pkg.dependencies["react-native-reanimated"] = "^3.10.0";
+  } else if (config.animation === "framer") {
+    pkg.dependencies["framer-motion"] = "^11.0.0";
+  }
+  if (platform === "mobile") {
+    pkg.dependencies["@lazorkit/wallet-mobile-adapter"] = "latest";
+    pkg.dependencies["@solana/web3.js"] = "^1.95.0";
+    pkg.dependencies["react-native-get-random-values"] = "~1.11.0";
+    pkg.dependencies["react-native-url-polyfill"] = "^2.0.0";
+    pkg.dependencies["buffer"] = "^6.0.3";
+    pkg.dependencies["expo-crypto"] = "~15.0.0";
+    pkg.dependencies["expo-linking"] = "~8.0.11";
+    pkg.dependencies["expo-web-browser"] = "~15.0.10";
+    pkg.dependencies["expo-clipboard"] = "~7.0.0";
+    if (config.styling === "nativewind") {
+      pkg.dependencies["nativewind"] = "^4.0.0";
+      pkg.devDependencies["tailwindcss"] = "^3.4.0";
+    }
+  } else {
+    pkg.dependencies["@lazorkit/wallet"] = "latest";
+    pkg.dependencies["@solana/web3.js"] = "^1.95.0";
+    pkg.dependencies["@coral-xyz/anchor"] = "^0.30.0";
+    pkg.dependencies["buffer"] = "^6.0.3";
+    if (config.webFramework === "vite") {
+      pkg.devDependencies["vite-plugin-node-polyfills"] = "^0.22.0";
+    }
+    if (config.styling === "tailwind" && config.webFramework === "vite") {
+      pkg.devDependencies["tailwindcss"] = "^3.4.0";
+      pkg.devDependencies["postcss"] = "^8.4.0";
+      pkg.devDependencies["autoprefixer"] = "^10.4.0";
+    }
+  }
+  if (config.backend === "supabase") {
+    pkg.dependencies["@supabase/supabase-js"] = "^2.39.0";
+  } else if (config.backend === "firebase") {
+    pkg.dependencies["firebase"] = "^10.7.0";
+  }
   await fs2.writeJson(pkgPath, pkg, { spaces: 2 });
-  const templatesDir = getTemplatesDir();
-  await copyTemplate(path2.join(templatesDir, "state", config.state), path2.join(appDir, "lib/store"), config);
-}
-async function addComponents(appDir, config) {
-  if (config.components === "none") return;
-  const templatesDir = getTemplatesDir();
-  await copyTemplate(path2.join(templatesDir, "components", config.components), path2.join(appDir, "components/ui"), config);
 }
-async function addExamples(appDir, platform, config) {
-  const templatesDir = getTemplatesDir();
-  const examplesDir = path2.join(templatesDir, "examples", platform);
-  const targetDir = platform === "mobile" ? path2.join(appDir, "app") : path2.join(appDir, "app/examples");
-  await copyTemplate(examplesDir, targetDir, config);
+async function addEasConfig(appDir, config) {
+  const easConfig = {
+    cli: { version: ">= 7.0.0" },
+    build: {
+      development: { developmentClient: true, distribution: "internal" },
+      preview: { distribution: "internal" },
+      production: {}
+    },
+    submit: { production: {} }
+  };
+  await fs2.writeJson(path2.join(appDir, "eas.json"), easConfig, { spaces: 2 });
 }
-async function copyTemplate(src, dest, config) {
+async function copyTemplate(src, dest, config, exclude = []) {
   if (!await fs2.pathExists(src)) return;
   await fs2.ensureDir(dest);
   const files = await fs2.readdir(src, { withFileTypes: true });
   for (const file of files) {
+    if (exclude.includes(file.name)) continue;
     const srcPath = path2.join(src, file.name);
     const destName = file.name.replace(/\.ejs$/, "");
     const destPath = path2.join(dest, destName);
@@ -245,7 +344,9 @@ async function copyTemplate(src, dest, config) {
     } else if (file.name.endsWith(".ejs")) {
       const content = await fs2.readFile(srcPath, "utf-8");
       const rendered = ejs.render(content, config);
-      await fs2.writeFile(destPath, rendered);
+      if (rendered.trim()) {
+        await fs2.writeFile(destPath, rendered);
+      }
     } else {
       await fs2.copy(srcPath, destPath);
     }
@@ -285,13 +386,17 @@ program.name("create-lightning-scaffold").description("Scaffold projects with La
     const preset = opts.preset || "mobile";
     const isMobile = preset === "mobile" || preset === "fullstack-mobile";
     const hasBackend = preset.includes("fullstack") || preset === "monorepo";
+    const hasWeb = preset === "web" || preset === "fullstack-web" || preset === "monorepo";
     config = {
       name,
       preset,
-      backend: hasBackend ? "supabase" : "none",
+      webFramework: "nextjs",
+      backend: hasBackend ? "nestjs-postgres" : "none",
       styling: isMobile ? "nativewind" : "tailwind",
       state: "zustand",
       components: isMobile ? "nativewind-ui" : "shadcn",
+      animation: isMobile ? "reanimated" : "framer",
+      eas: isMobile,
       packageManager: "npm",
       gitInit: true
     };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-lightning-scaffold",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "CLI to scaffold projects with LazorKit SDK integration",
   "type": "module",
   "bin": {

package/templates/backend/firebase/index.ts

@@ -1,6 +1,5 @@
 import { initializeApp } from "firebase/app";
-import { getAuth } from "firebase/auth";
-import { getFirestore, doc, setDoc, collection, query, where, getDocs, orderBy } from "firebase/firestore";
+import { getFirestore, doc, setDoc, getDoc, collection, query, where, getDocs, orderBy, limit, addDoc, serverTimestamp } from "firebase/firestore";
 
 const firebaseConfig = {
   apiKey: process.env.EXPO_PUBLIC_FIREBASE_API_KEY || process.env.NEXT_PUBLIC_FIREBASE_API_KEY,
@@ -9,17 +8,95 @@ const firebaseConfig = {
 };
 
 const app = initializeApp(firebaseConfig);
-export const auth = getAuth(app);
 export const db = getFirestore(app);
 
-// Example: Save wallet to user profile
-export async function saveWallet(userId: string, walletAddress: string) {
-  return setDoc(doc(db, "wallets", userId), { address: walletAddress, updatedAt: new Date() });
+// Types
+export interface User {
+  walletAddress: string;
+  createdAt: Date;
 }
 
-// Example: Get user's transactions
-export async function getTransactions(walletAddress: string) {
-  const q = query(collection(db, "transactions"), where("walletAddress", "==", walletAddress), orderBy("createdAt", "desc"));
+export interface SwapRecord {
+  walletAddress: string;
+  fromToken: string;
+  toToken: string;
+  fromAmount: string;
+  toAmount: string;
+  signature: string;
+  createdAt: Date;
+}
+
+// User Management
+export async function createOrGetUser(walletAddress: string) {
+  const userRef = doc(db, "users", walletAddress);
+  const userSnap = await getDoc(userRef);
+
+  if (userSnap.exists()) return { id: userSnap.id, ...userSnap.data() };
+
+  await setDoc(userRef, { walletAddress, createdAt: serverTimestamp() });
+  return { id: walletAddress, walletAddress, createdAt: new Date() };
+}
+
+// Swap History
+export async function saveSwap(swap: Omit<SwapRecord, "createdAt">) {
+  const docRef = await addDoc(collection(db, "swaps"), {
+    ...swap,
+    createdAt: serverTimestamp(),
+  });
+  return { id: docRef.id, ...swap };
+}
+
+export async function getSwapHistory(walletAddress: string, maxResults = 20) {
+  const q = query(
+    collection(db, "swaps"),
+    where("walletAddress", "==", walletAddress),
+    orderBy("createdAt", "desc"),
+    limit(maxResults)
+  );
   const snapshot = await getDocs(q);
   return snapshot.docs.map((d) => ({ id: d.id, ...d.data() }));
 }
+
+// Message Signatures (for verification records)
+export async function saveSignature(walletAddress: string, message: string, signature: string) {
+  const docRef = await addDoc(collection(db, "signatures"), {
+    walletAddress,
+    message,
+    signature,
+    createdAt: serverTimestamp(),
+  });
+  return { id: docRef.id };
+}
+
+/*
+Firestore Security Rules - Add to firestore.rules:
+
+rules_version = '2';
+service cloud.firestore {
+  match /databases/{database}/documents {
+    match /users/{walletAddress} {
+      allow read, write: if true; // Adjust based on your auth
+    }
+    match /swaps/{swapId} {
+      allow read, write: if true;
+    }
+    match /signatures/{sigId} {
+      allow read, write: if true;
+    }
+  }
+}
+
+Firestore Indexes - Add to firestore.indexes.json:
+{
+  "indexes": [
+    {
+      "collectionGroup": "swaps",
+      "queryScope": "COLLECTION",
+      "fields": [
+        { "fieldPath": "walletAddress", "order": "ASCENDING" },
+        { "fieldPath": "createdAt", "order": "DESCENDING" }
+      ]
+    }
+  ]
+}
+*/