BasilicEVM: FullStack EVM Project Starter

A performance-optimized development stack for EVM applications. Built with Foundry, viem/wagmi, and Next.js 15.

🚧 Note: This project is in active development (80% complete) - feel free to explore and contribute! 🏗️

Stack Components

• Contracts: Foundry, Solidity ^0.8.19
• Chain Integration: viem/wagmi, Alchemy RPC
• Frontend: Next.js 15, React Server Components
• Data Layer: Ponder indexing, PostgreSQL ( Supabase )

Project Structure

Apps

• apps/next-thirdweb - Next.js with ThirdWeb connect
• apps/next-rainbow - Next.js with RainbowKit
• apps/ponder - Chain indexing service with GraphQL + RPC API
• apps/supabase - Local Supabase PostgreSQL instance
• apps/node - NodeJS service starter
• apps/docs - Docs starter.

Packages

• packages/ui - Shadcn/ui and custom components
• packages/core - Chain interactions, contract ABIs
• packages/api - Ponder api client, api sdk for queries and subscriptions
• packages/markets - Market data components
• packages/react - Web3 React hooks
• packages/lib - Shared utilities
• packages/tsconfig - TypeScript configuration

This monorepo structure is designed for building modular blockchain applications with reusable SDKs. The separation of packages makes it easy for other teams to integrate specific functionality into their dapps, whether they need just the core contract interactions, React hooks, or the complete UI components. While these packages work seamlessly within the monorepo, they are also designed to be published individually to npm, allowing external projects to install and use specific packages as needed.

Development Setup

Requirements

• Node.js 18+
• pnpm
• Foundry

Quick Start

npm install -g pnpm
curl -L https://foundry.paradigm.xyz | bash
foundryup
git clone https://github.com/blockmatic/basilic-evm.git
cd basilic-evm
pnpm install

Backend Architecture

Our backend uses a combination of Ponder.sh and Supabase:

• Ponder.sh: Handles all database operations, migrations, and provides GraphQL + RPC APIs
• Supabase:
  • Local development via apps/supabase
  • Database branching and preview environments
  • Vercel integration for deployments
  • Database management tools and monitoring

For detailed information about our backend architecture, please refer to BACKEND.md.

Design System

Our design system provides a comprehensive collection of reusable components built on top of shadcn/ui, offering a consistent and maintainable UI framework across all applications. The system includes:

• Pre-built, customizable UI components
• Consistent theming and styling
• Accessibility-first design patterns
• Responsive layouts and components
• Dark/light mode support

All components and documentation can be found in the packages/ui directory. The design system can be utilized in any application within the monorepo, from landing pages to complex dApps.

Development Commands

pnpm backend:start  # Start Supabase & Ponder 
pnpm backend:reset  # Resets Supabase & Ponder 
pnpm backend:stop  # Stops Supabase & Ponder 
pnpm dev        # Dev server
pnpm build      # Production build
pnpm test       # Run tests

AI-Powered Development Workflow

• Specialized cursor rules (.cursor/rules) – Ensures code consistency and quality.
• Streamlined UI Generation – Simplifies front-end development with v0.dev.
• Automated Code Reviews – Provides AI-driven best practice suggestions.
• AI-Powered Database Design – Accelerates schema iteration with postgres.new and Supabase AI agent.

AI Tools Used

• Cursor.so – AI-assisted development environment.
• v0.dev – Automated UI generation.
• postgres.new – AI-powered database schema design.
• CodeRabbit.ai – AI-driven code reviews.
• Supabase.com – AI-powered backend tools.

Technical References

• viem
• wagmi
• tanstack query
• thirdweb connect
• Next.js
• Ponder
• Supabase
• Foundry
• EIP-2771: Meta Transactions
• 0x Protocol Gasless API

Contributing

See CONTRIBUTING.md for development guidelines.

License

WTFPL © blockmatic.io