Update to Allium

{
  "name": "vercel-app-deployment",
  "description": "**Required for Vercel app tools.**\n\nRead this skill BEFORE using create_vercel_app to understand\napp types, configuration options, and the iteration workflow.",
  "included_files": [],
  "skill_md_contents": "---\nname: vercel-app-deployment\ndescription: |\n  **Required for Vercel app tools.**\n\n  Read this skill BEFORE using create_vercel_app to understand\n  app types, configuration options, and the iteration workflow.\n---\n\n# Vercel App Deployment\n\nGenerate and deploy Next.js apps powered by Allium data APIs.\n\n## App Types\n\n### wallet_tracker\n\nTrack wallet holdings, PnL, and transaction history.\n\n**Features:**\n\n- Token holdings with USD values\n- PnL chart showing portfolio value over time\n- Transaction history with send/receive indicators\n- Multi-chain support\n\n**Options:**\n\n```json\n{\n  \"show_pnl\": true,           // Show PnL chart (default: true)\n  \"show_transactions\": true   // Show transaction history (default: true)\n}\n```\n\n**Example:**\n\n```json\n{\n  \"app_type\": \"wallet_tracker\",\n  \"title\": \"My Wallet Tracker\",\n  \"chains\": [\"ethereum\", \"polygon\", \"arbitrum\"],\n  \"theme\": \"dark\",\n  \"options\": {\"show_pnl\": true, \"show_transactions\": true}\n}\n```\n\n### token_analytics\n\nAnalyze token prices and market stats.\n\n**Features:**\n\n- Price chart with time range selection (24H, 7D, 30D, 90D)\n- Token stats cards (price, price change 24h)\n\n**Options:**\n\n```json\n{\n  \"show_stats\": true    // Show stats cards (default: true)\n}\n```\n\n**Example:**\n\n```json\n{\n  \"app_type\": \"token_analytics\",\n  \"title\": \"Token Analyzer\",\n  \"chains\": [\"ethereum\", \"base\"],\n  \"theme\": \"light\"\n}\n```\n\n### price_chart\n\nDedicated OHLCV price chart with dynamic coloring and detailed stats.\n\n**Features:**\n\n- OHLCV (Open, High, Low, Close, Volume) price chart\n- Dynamic green/red coloring based on price direction\n- Detailed OHLC tooltip showing all price data points\n- Stats card with current price, 24h change, 24h high/low\n- Time range selection (24H, 7D, 30D, 90D)\n- Optional pre-configured token address\n\n**Options:**\n\n```json\n{\n  \"default_token_address\": null,  // Pre-configured token (default: null)\n  \"default_chain\": null,          // Pre-configured chain (default: first chain)\n  \"show_ohlc_details\": true,      // Show OHLC in tooltip (default: true)\n  \"show_stats_card\": true,        // Show price stats card (default: true)\n  \"show_token_selector\": true     // Allow changing token (default: true)\n}\n```\n\n**Example:**\n\n```json\n{\n  \"app_type\": \"price_chart\",\n  \"title\": \"WETH Price Tracker\",\n  \"chains\": [\"ethereum\", \"base\", \"arbitrum\"],\n  \"theme\": \"dark\",\n  \"options\": {\n    \"default_token_address\": \"0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2\",\n    \"show_ohlc_details\": true\n  }\n}\n```\n\n**When to use price_chart vs token_analytics:**\n\n- Use `price_chart` when the focus is on detailed price visualization with OHLCV data and dynamic coloring\n- Use `token_analytics` for general token analysis with market cap, volume, and liquidity stats\n\n### wallet_flows\n\nVisualize wallet inflows and outflows as a Sankey diagram.\n\n**Features:**\n\n- Sankey flow chart showing token transfers\n- Table view with detailed inflow/outflow data\n- Aggregates transfers by counterparty\n\n**Example:**\n\n```json\n{\n  \"app_type\": \"wallet_flows\",\n  \"title\": \"Wallet Flow Analyzer\",\n  \"chains\": [\"ethereum\", \"polygon\"],\n  \"theme\": \"dark\"\n}\n```\n\n### custom_dashboard\n\nCustom SQL dashboard with configurable widgets.\n\n**Features:**\n\n- Data tables from Allium Explorer queries\n- Charts (line, bar, pie) from query results\n- Metric cards for single values\n\n**Options:**\n\n```json\n{\n  \"widgets\": [\n    {\n      \"type\": \"metric\",\n      \"title\": \"Total Users\",\n      \"query_id\": \"abc123\"\n    },\n    {\n      \"type\": \"chart\",\n      \"title\": \"Daily Active Users\",\n      \"query_id\": \"def456\",\n      \"chart_type\": \"line\"\n    },\n    {\n      \"type\": \"table\",\n      \"title\": \"Top Wallets\",\n      \"query_id\": \"ghi789\"\n    }\n  ]\n}\n```\n\nWidget types:\n\n- `metric`: Single value (first cell of query result)\n- `chart`: Line, bar, or pie chart\n- `table`: Data table with all results\n\n## Supported Chains\n\n- `ethereum` - Ethereum Mainnet\n- `polygon` - Polygon PoS\n- `arbitrum` - Arbitrum One\n- `optimism` - Optimism\n- `base` - Base\n- `avalanche` - Avalanche C-Chain\n- `bsc` - BNB Smart Chain\n- `solana` - Solana\n\n## Workflow\n\n### Initial Creation\n\n1. Call `create_vercel_app` with app type and options\n2. Tool generates Next.js app and deploys to Vercel\n3. Returns `app_id`, `deployment_url`, and `claim_url`\n4. User clicks `claim_url` to take ownership on Vercel\n5. User adds `ALLIUM_API_KEY` in Vercel project settings\n\n### Iteration\n\n1. `list_vercel_app_files` - See file structure\n2. `read_vercel_app_file` - Read files to modify\n3. `write_vercel_app_file` - Update files (can batch multiple writes)\n4. `deploy_vercel_app` - Deploy changes\n\n**Example iteration:**\n\n```text\nUser: \"Add a dark mode toggle\"\n\n1. list_vercel_app_files(app_id=\"abc123\")\n   -> See: app/layout.tsx, components/...\n\n2. read_vercel_app_file(app_id=\"abc123\", file_path=\"app/layout.tsx\")\n   -> Get current layout code\n\n3. write_vercel_app_file(app_id=\"abc123\", file_path=\"components/ThemeToggle.tsx\", content=\"...\")\n   -> Create new component\n\n4. write_vercel_app_file(app_id=\"abc123\", file_path=\"app/layout.tsx\", content=\"...\")\n   -> Update layout to include toggle\n\n5. deploy_vercel_app(app_id=\"abc123\")\n   -> Deploy updated app\n```\n\n## Post-Deployment Setup\n\nAfter claiming the app, the user must:\n\n1. Go to Vercel project settings\n2. Navigate to Environment Variables\n3. Add: `ALLIUM_API_KEY` = their API key from <https://app.allium.so/settings/api-keys>\n4. Redeploy the app (or wait for next deployment)\n\n## File Structure\n\nGenerated apps follow this structure:\n\n```text\napp/\n  layout.tsx      # Root layout with metadata\n  page.tsx        # Main page component\n  globals.css     # Global styles\n  api/            # API routes (proxy to Allium)\n    wallet/\n      balances/route.ts\n      pnl/route.ts\n      transactions/route.ts\ncomponents/\n  Holdings.tsx    # Feature components\n  WalletInput.tsx\n  ChainSelector.tsx\n  ...\npackage.json      # Dependencies\ntsconfig.json     # TypeScript config\ntailwind.config.js\nnext.config.js\n```\n\n## Tips\n\n- **Theme**: `dark` works best for blockchain apps\n- **Chains**: Include chains your users are most likely to use\n- **Custom Dashboard**: Create queries in Allium Explorer first, then reference their IDs\n- **Iteration**: Make multiple file changes before deploying to batch updates\n"
}