ImpactAI Documentation

git clone https://github.com/your-username/impactai.git
cd impactai
npm install

cp .env.local.example .env.local

# .env.local
GEMINI_API_KEY=your-gemini-key
NEXTAUTH_SECRET=any-random-string-for-local-dev
NEXTAUTH_URL=http://localhost:3000

npm run dev
# Open http://localhost:3000

impactai/
├── src/
│   ├── app/
│   │   ├── api/
│   │   │   ├── auth/[...nextauth]/route.ts   # NextAuth handler
│   │   │   ├── generate/route.ts             # Gemini AI generation (rate-limited)
│   │   │   └── tokens/
│   │   │       ├── route.ts                  # GET list / POST save tokens
│   │   │       ├── [id]/route.ts             # GET / PATCH a single token
│   │   │       └── stats/route.ts            # Aggregate platform stats
│   │   ├── docs/page.tsx                     # This page
│   │   ├── launch/page.tsx                   # Token creation app
│   │   ├── portfolio/page.tsx               # Creator's launched tokens
│   │   ├── layout.tsx                        # Root layout + providers
│   │   ├── page.tsx                          # Landing page
│   │   └── globals.css
│   ├── components/
│   │   ├── AuthModal.tsx                     # Wallet + OAuth modal
│   │   ├── AuthSessionProvider.tsx           # NextAuth SessionProvider
│   │   ├── FeeSplitVisual.tsx                # Interactive fee bars
│   │   ├── GeneratingScreen.tsx              # AI loading animation
│   │   ├── HomeScreen.tsx                    # Cause input screen
│   │   ├── LaunchedScreen.tsx                # Post-launch dashboard (saves token)
│   │   ├── LiveLaunchesList.tsx              # Live launches list
│   │   ├── Navbar.tsx                        # Header with auth state
│   │   ├── PreviewScreen.tsx                 # Token review screen
│   │   ├── ThemeProvider.tsx                 # next-themes wrapper
│   │   ├── ThemeToggle.tsx                   # Light/dark/system toggle
│   │   └── TickerBar.tsx                     # Live launches ticker
│   ├── lib/
│   │   ├── constants.ts                      # Static data & AI prompt
│   │   ├── tokens.ts                         # Redis token store + stats
│   │   ├── ratelimit.ts                      # Upstash rate limiter (fail-open)
│   │   ├── useConnectedUser.ts               # Unified wallet + OAuth identity
│   │   ├── useAnimatedCounter.ts             # Animated number hook
│   │   └── utils.ts                          # cn(), formatCurrency(), etc.
│   └── types/
│       ├── index.ts                          # App + UI types
│       └── token.ts                          # LiveToken & PlatformStats
├── .env.local.example
├── next.config.js
├── tailwind.config.ts
└── tsconfig.json

npm install @bagsfm/bags-sdk @solana/web3.js @solana/wallet-adapter-react

import { BagsSDK } from "@bagsfm/bags-sdk";

const sdk = new BagsSDK({ apiKey: process.env.BAGS_API_KEY });

const result = await sdk.launchToken({
  name: token.name,
  ticker: token.ticker,
  description: token.description,
  feeShares: {
    cause:    "0.40",  // 40% → community wallet
    holders:  "0.30",  // 30% → token holders
    creator:  "0.20",  // 20% → you
    platform: "0.10",  // 10% → ImpactAI
  },
  causeWallet: "SOLANA_WALLET_ADDRESS_FOR_CAUSE",
  metadata: {
    image: token.emoji,
    tags:  token.tags,
  },
});

console.log("Token live:", result.mintAddress);

const { user, walletUser, setWalletUser, disconnect } = useConnectedUser();

// user = persisted wallet user, else the NextAuth session user
// creatorIdOf(user) → stable id used to attribute & filter launched tokens

POST /api/generate
Content-Type: application/json

{
  "cause": "Solar panels for 200 homes in rural Ethiopia"
}

{
  "token": {
    "name": "EthioSolar",
    "ticker": "ESOL",
    "description": "EthioSolar is lighting up 200 homes...",
    "emoji": "☀️",
    "causeWallet": "Solar panel installation for 200 rural homes",
    "viralHook": "I just launched a solar token — trade it and power Ethiopia",
    "tags": ["energy", "africa", "solar"]
  }
}

POST /api/tokens
{
  "name": "EthioSolar",
  "ticker": "ESOL",
  "description": "...",
  "emoji": "☀️",
  "causeWallet": "...",
  "viralHook": "...",
  "tags": ["energy", "solar"],
  "creatorId": "wallet:7xk...",   // stable creator identity
  "creatorWallet": "7xk...",
  "creatorDisplay": "7xk…9fA"
}

// → 201 { token: LiveToken }  (raised/supporters/volume24h/change24h/txCount = 0)

GET  /api/auth/signin              # Sign-in page redirect
GET  /api/auth/signout             # Signs the user out
GET  /api/auth/session             # Returns current session JSON
GET  /api/auth/callback/google     # Google OAuth callback
GET  /api/auth/callback/github     # GitHub OAuth callback
GET  /api/auth/csrf                # CSRF token

# Install Vercel CLI
npm i -g vercel

# Deploy (first time sets up the project)
vercel

# Set environment variables
vercel env add GEMINI_API_KEY
vercel env add NEXTAUTH_SECRET
vercel env add NEXTAUTH_URL          # https://your-app.vercel.app
# Storage — or add a Vercel KV / Upstash store, which injects these for you
vercel env add KV_REST_API_URL
vercel env add KV_REST_API_TOKEN
vercel env add GOOGLE_CLIENT_ID
vercel env add GOOGLE_CLIENT_SECRET
vercel env add GITHUB_CLIENT_ID
vercel env add GITHUB_CLIENT_SECRET

# Deploy to production
vercel --prod

npm install @bagsfm/bags-sdk @solana/web3.js

const handleLaunch = useCallback(async () => {
  if (!user && !walletUser) { setAuthOpen(true); return; }

  const { BagsSDK } = await import("@bagsfm/bags-sdk");
  const sdk = new BagsSDK({ apiKey: process.env.NEXT_PUBLIC_BAGS_API_KEY });

  try {
    const result = await sdk.launchToken({
      name:        token!.name,
      ticker:      token!.ticker,
      description: token!.description,
      feeShares: {
        cause:    "0.40",
        holders:  "0.30",
        creator:  "0.20",
        platform: "0.10",
      },
      causeWallet: "YOUR_CAUSE_SOLANA_WALLET_ADDRESS",
    });
    console.log("Mint address:", result.mintAddress);
    setScreen("launched");
  } catch (err) {
    setError("Launch failed. Check your Bags API key.");
  }
}, [token, user, walletUser]);