Skip to main content

Solana Starter Kit

Don't have an app yet? Start here! The Solana Starter Kit is a comprehensive template that helps you go from idea to live app in the shortest time possible. It comes pre-configured with all the essential infrastructure you need to build a modern Solana application.

What's Included​

The starter kit includes pre-configured integrations with leading infrastructure providers:

  • 🔐 Wallet Authentication - Privy for seamless user onboarding
  • 👥 Social Features - Tapestry for profiles, follows, posts, and social graph
  • 💰 Token Swapping - 0x for DEX aggregation and trading
  • 📊 Portfolio View - Zerion for wallet analytics and asset tracking
  • 🔗 RPC Calls - Helius for reliable Solana blockchain access

Quick Start​

1. Clone the Repository​

git clone https://github.com/Primitives-xyz/solana-starter-kit
cd solana-starter-kit

2. Get Your API Keys​

Sign up for API keys from each infrastructure partner:

  • Privy - Web3 authentication and embedded wallet infrastructure
  • Tapestry - Social graph and onchain identity API
  • 0x - Token swapping and DEX aggregation
  • Zerion - Portfolio analytics and wallet data
  • Helius - Solana RPC and blockchain infrastructure

3. Configure Environment​

cp .env.example .env.local

Update .env.local with your API credentials:

# Tapestry - Social Features
NEXT_PUBLIC_TAPESTRY_API_KEY=your_tapestry_api_key_here

# Privy - Authentication
NEXT_PUBLIC_PRIVY_APP_ID=your_privy_app_id_here

# Helius - RPC & NFT Data
NEXT_PUBLIC_HELIUS_API_KEY=your_helius_api_key_here

# Additional API keys for other services...

4. Install Dependencies and Run​

pnpm install
pnpm run dev

Your app will be running at http://localhost:3000 with all infrastructure ready to go!

Key Features Out of the Box​

Social Features (Tapestry)​

  • ✅ User profile creation and management
  • ✅ Follow/unfollow system
  • ✅ Post creation and social feeds
  • ✅ Import existing Tapestry social connections

Authentication (Privy)​

  • ✅ Wallet connection (Phantom, Solflare, etc.)
  • ✅ Email/SMS authentication
  • ✅ Embedded wallet creation
  • ✅ User session management

Trading (0x)​

  • ✅ Token swapping interface
  • ✅ DEX aggregation for best prices
  • ✅ Slippage protection

Portfolio Tracking (Zerion)​

  • ✅ Wallet performance charts
  • ✅ Transaction history
  • ✅ Token balance tracking
  • ✅ DeFi position monitoring

NFT Support (Helius)​

  • ✅ NFT portfolio viewer
  • ✅ Collection analytics
  • ✅ Metadata display
  • ✅ Transaction history

Architecture Overview​

The starter kit follows modern web development best practices:

  • Frontend: Next.js 14 with App Router and TypeScript
  • Styling: Tailwind CSS with shadcn/ui components
  • State Management: React hooks and context
  • Blockchain: Solana Web3.js with wallet adapters
  • API Integration: Pre-configured clients for all services

Customization​

The starter kit is designed to be easily customizable:

  1. Branding: Update colors, fonts, and logos in tailwind.config.ts
  2. Features: Enable/disable specific integrations in the config
  3. UI Components: Extend or replace shadcn/ui components
  4. Business Logic: Add your unique features on top of the foundation

Getting Help​

  • Documentation: Each integration includes detailed setup guides
  • Community: Join our Discord for support
  • Issues: Report problems on GitHub

Why Use the Starter Kit?​

Building a Solana app from scratch requires integrating multiple complex services. The starter kit eliminates this friction by providing:

  • Faster Time to Market: Skip weeks of infrastructure setup
  • Best Practices: Pre-configured with optimal settings
  • Proven Integrations: Battle-tested by production apps
  • Easy Onboarding: Get users engaged from day one with existing social connections

Next Steps​

Once you have the starter kit running:

  1. Explore the Code: Understand how each integration works
  2. Customize the UI: Make it match your brand and vision
  3. Add Your Features: Build on top of the solid foundation
  4. Deploy: Use Vercel or your preferred hosting platform

Ready to build something amazing? Get the starter kit →

Need help with Tapestry integration? Continue to our Quickstart Guide for detailed API documentation.