Solana Starter Kit | Tapestry Documentation

On this page

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 →