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](https://www.privy.io/) for seamless user onboarding
- **👥 Social Features** 
  - [Tapestry](/content/site-root.html) for profiles, follows, posts, and social graph
- **💰 Token Swapping** 
  - [0x](https://0x.org/) for DEX aggregation and trading
- **📊 Portfolio View** 
  - [Zerion](https://zerion.io/) for wallet analytics and asset tracking
- **🔗 RPC Calls** 
  - [Helius](https://www.helius.dev/) for reliable Solana blockchain access

## Quick Start
### 1. Clone the Repository
```bash
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](https://www.privy.io/)** 
  - Web3 authentication and embedded wallet infrastructure
- **[Tapestry](https://app.usetapestry.dev/)** 
  - Social graph and onchain identity API
- **[0x](https://0x.org/docs/api)** 
  - Token swapping and DEX aggregation
- **[Zerion](https://developers.zerion.io/)** 
  - Portfolio analytics and wallet data
- **[Helius](https://www.helius.dev/)** 
  - Solana RPC and blockchain infrastructure
### 3. Configure Environment
```bash
cp .env.example .env.local
```
Update `.env.local` with your API credentials:
```env
# 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
```bash
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](https://discord.gg/tapestry) for support
- **Issues**: Report problems on [GitHub](https://github.com/Primitives-xyz/solana-starter-kit/issues)

## 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 →](https://github.com/Primitives-xyz/solana-starter-kit)