Basilic: Web3 & AI App Starter

Full-stack monorepo starter for Web3 and AI apps. Built for teams shipping products that need SDKs, public APIs, and multichain support—without rebuilding auth, OpenAPI tooling, or design systems from scratch. Ship features faster; security, docs, and AI-assisted workflows are included.

🚧 Active development — Explore, fork, and contribute. 🏗️

Features

• 🤖 AI-first dev workflow — Agent rules, skills, MCP integrations, and automated CodeRabbit reviews
• 🔌 REST API & JWT — OpenAPI spec, Swagger UI, JWT auth for all clients
• 📦 SDK generation — Type-safe clients from OpenAPI via HeyAPI
• 🧩 Web3 & AI starters — Ready-to-use templates for Next.js, React, Expo, Fastify, and Ponder
• 🔓 Zero vendor lock-in — Run on VPS, AWS, Vercel, or local
• 🎨 Turbo monorepo + design system — ShadcnUI components with shared utilities
• ⚙️ Preconfigured dev tools — Biome, Git workflows, hooks, and security checks
• 🛡️ Security & quality — Automated checks in CI (e.g. Gitleaks, OSV)
• ⛓️ Multichain — EVM, Solana, Cosmos; shared validation and chain-specific tooling
• 📐 Conventions — Cursor rules per domain, @repo/sentry, Pino logging, shared TS and style
• 🧑‍💻 TypeScript-first — End-to-end types from database to frontend

Technology stack

• AI: AI SDK, OpenAI, Claude, Grok
• Frontend: Next.js 16, React 19, Tailwind, ShadcnUI
• Backend: Fastify, PostgreSQL, Supabase
• Web3: Solidity, Viem, Wagmi, Ponder, Solana
• DevOps: pnpm, TurboRepo, TypeScript, Biome, ESLint

Apps

• API — Type-safe REST API built with Fastify & OpenAPI
• Web App — Next.js app with monorepo integration
• Documentation — Fumadocs-based docs site for architecture, ADRs, and development workflows

Packages

• @repo/core — Runtime-agnostic API client and types generated from OpenAPI specs
• @repo/react — React Query hooks for @repo/core API functions
• @repo/ui — Shared UI component library (Shadcn/ui, Tailwind)
• @repo/utils — Shared utilities (async, data, debug, error, logger, web3)
• @repo/sentry — Common captureError interface for error reporting
• @repo/email — Email template library built with React Email
• @repo/notif — Notification service (email, activity) with type-safe schemas

Scripts

Run with pnpm <script>.

Setup

• setup — Full setup (install, hooks, gitleaks, osv, database)
• setup:gitleaks, setup:osv — Install Gitleaks, OSV scanner
• setup:database — Database tools Primary
• build — Build packages and apps
• dev — Start dev (core, react, sentry, utils, fastify, next)
• qa — Full check: install → checktypes → lint → build → test Format / Lint
• checktypes — Type-check all packages
• format — Format code (Biome)
• lint — Lint with Biome + ESLint
• lint:biome, lint:biome:fix — Biome check, fix
• lint:eslint, lint:eslint:fix — ESLint check, fix
• lint:fix — Fix both linters Test
• test — Run tests
• test:e2e — E2E (Fastify + Next) Security
• security:block-files — Block sensitive file patterns
• security:secrets — Scan staged files for secrets
• security:secrets:full — Full Gitleaks scan
• security:osv — OSV vulnerability scan
• security:audit — pnpm audit (moderate+)
• security:check — Run security check script Hooks
• hooks:pre-commit — Pre-commit: security + Biome staged
• hooks:security — Block files, scan secrets, OSV Misc
• update-deps — Update pnpm and all dependencies

Documentation

Full docs: basilic-docs.vercel.app