CAST QUEST Frames is a Web3-native social photo protocol that feels like Instagram, mints like Zora, extends like Farcaster Frames, and builds like Remix β powered by a Smart Brain multi-agent AI.
- Chain-first: Built on Base with multi-chain EVM support
- Creator-first: Onchain minting, collecting, royalties, and programmable fees
- Builder-first: Frames, SDK, and a Remix-style module builder
- AI-native: Smart Brain agents for pricing, previews, tagging, and system optimization
apps/ web/ - Next.js app (feed, profiles, frames) admin/ - Next.js admin app (fees, templates, AI settings) mobile/ - React Native / Expo app
packages/ contracts/ - Solidity contracts (Base + EVM) sdk/ - CAST QUEST SDK integration (used here) ai-brain/ - Multi-agent Smart Brain orchestration ui-kit/ - Shared UI components & design system
infra/ api-gateway/ - API entrypoint (frames, mint, collect) indexer/ - Onchain event indexer workers/ - Background jobs (AI, notifications, analytics) k8s/ - Kubernetes manifests
docs/ whitepaper/ - Vision & protocol architecture/- Diagrams & technical design sdk/ - Dev docs & examples product/ - User & admin guides
.github/ - CI/CD, issue templates, PR templates scripts/ - Dev, deploy, Smart Brain operator examples/frames/ - Example frame definitions
See CONTRIBUTING.md.
Required:
- Node.js 20+ (to prevent ERR_INVALID_THIS errors)
- pnpm 9+ (package manager)
Install with nvm:
nvm install 20
nvm use 20
npm install -g pnpm@9Or use the .nvmrc file:
nvm use # Automatically uses Node 20.19.6CastQuest Frames includes two production-ready dashboards with neo-glow theme for creators and administrators.
Port: 3000 | URL: http://localhost:3000/dashboard
A creator-focused dashboard with AI tools and community features:
- β¨ AI Frame Builder - Generate frames with natural language
- π Analytics - Track views, engagement, and revenue
- πͺ Marketplace - Browse and purchase frame templates
- π¬ Community Hub - Social feed with interactions
- π― Frame Management - Create and monitor frames
- π Leaderboard - Global rankings and achievements
- β‘ Quest System - Daily/weekly challenges
- π NFT Mints - Manage collectible mints
# Start user dashboard
cd apps/web && pnpm dev
# Access: http://localhost:3000/dashboardPort: 3010 | URL: http://localhost:3010/dashboard
A protocol management console with comprehensive monitoring:
- π Token Management - Monitor $CAST, $PIC, $VID, $AUDIO
- π Permission System - Role-based access control
- π° Fee Controls - Adjustable protocol fees
- π‘οΈ Risk Management - AI-powered detection (98% accuracy)
- π Protocol Metrics - TVL, volume, active users
- π‘ System Health - Real-time monitoring
- πΌοΈ Frame Monitoring - Track all frame activity
- π Activity Logs - Complete audit trail
# Start admin dashboard
cd apps/admin && pnpm dev -- -p 3010
# Access: http://localhost:3010/dashboard# Install dependencies
pnpm install
# Run both dashboards using self-healing script (recommended)
chmod +x scripts/self-healing-ui.sh
./scripts/self-healing-ui.sh
# Or run manually in separate terminals:
# Terminal 1: User Dashboard
cd apps/web && pnpm dev
# Terminal 2: Admin Dashboard
cd apps/admin && pnpm dev -- -p 3010π Full Documentation: See docs/DASHBOARDS.md for complete setup, configuration, deployment, and troubleshooting guides.
The CastQuest Frames repository includes a comprehensive dependency health monitoring system to ensure consistency, security, and reliability.
# Run comprehensive health check
bash scripts/master.sh health
# Run automated repair
bash scripts/repair-dependencies.sh
# Get AI-powered insights
.smartbrain/oracle.sh analyze
# Get upgrade recommendations
.smartbrain/oracle.sh recommend-upgrades
# Security vulnerability scan
.smartbrain/oracle.sh security-scan- CI/CD Health Checks: Automated health checks run on every push, PR, and daily at 6 AM UTC
- Pre-commit Hooks: Validate changes before they reach the repository
- Smart Brain Oracle: AI-powered dependency intelligence and predictive maintenance
- β Version Harmonization: TypeScript 5.3.3, @types/node 20.10.6, Next.js 14.2.35 (secure)
- π Security Scanning: Automated vulnerability detection with pnpm audit
- π Health Scoring: Real-time repository health metrics
- π€ AI Insights: Smart Brain Oracle for predictive maintenance
- π οΈ Auto-Repair: One-command dependency repair script
- π Comprehensive Reports: JSON output for CI/CD integration
π Full Documentation: See docs/DEPENDENCY-HEALTH.md for detailed health monitoring guide.
Site: https://castquest.xyz (placeholder) Docs: https://docs.castquest.xyz (placeholder) Sponsors: GitHub Sponsors / custom page
Social feeds will be onchain. Creators will own their rails. Builders will extend everything through Frames and SDKs. AI will act as the invisible Smart Brain across the entire stack.
A sovereign, mediaβfirst automation protocol combining:
- Frame Template Engine (Module 6 MEGA)
- Quest Engine (Module 5B MEGA)
- Mint Engine + Renderer + Automation (Module 7 MEGA)
- BASE Mock Onchain Layer (Module 4 MEGA)
- MobileβOptimized Admin Console
- Strategy Worker + Logs Dashboard
-
Yosef (Founder / Protocol Architect)
Vision, architecture, automation engine, operator console design. -
SMSDAO (Core Contributor)
Execution, module integration, system orchestration. -
AI Automation Partner
Script generation, module scaffolding, errorβresilient workflows.
/api/base/*/strategy- ShellLayout mobile UI
/quests/api/quests/*data/quests.json,quest-steps.json,quest-progress.json,quest-rewards.json
/frame-templates/api/frame-templates/*data/frame-templates.json
/mints/api/mints/*/api/frames/render/api/strategy/worker/*data/mints.json,mint-events.json,frames.json,worker-events.json
CastQuest is a sovereign automation protocol that turns:
Media β Templates β Frames β Mints β Quests β Strategy β Onchain
into a single expressive pipeline.
You are early.