Skip to content

kolyantrend/solia

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

3 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

Solia Banner

Solia - AI Content Monetization Platform on Solana

โš ๏ธ PRIVATE REPOSITORY - This is proprietary software. Do not share, fork, or redistribute without authorization.

A decentralized social platform for AI creators to monetize their content on the Solana blockchain. Create, share, and sell AI-generated images with SKR tokens. Built with React, Vite, and Supabase.

Twitter Solana

๐ŸŒŸ Features

Core Functionality

  • ๐ŸŽจ AI Image Generation - Create unique images using advanced AI models
  • ๐Ÿ’ฐ Content Monetization - Sell AI-generated images directly to buyers with SKR tokens
  • ๐Ÿ“ฑ Social Feed - Discover trending creations with smart Hot/New/Trends algorithms
  • ๐Ÿ‘ค Creator Profiles - Customizable profiles with Twitter verification
  • ๐Ÿ“Š Analytics Dashboard - Real-time platform statistics and insights
  • ๐Ÿ”ฅ Top Creators Ticker - Rotating showcase of trending artists

Advanced Features

  • ๐Ÿง  Smart Sorting Algorithms - Time-decay scoring for natural content rotation
  • ๐ŸŽ Referral System - Bring new users and earn from their activity (15% on generations, 15% on purchases)
  • ๐Ÿ‘ฅ Follow System - Build your creator network
  • โค๏ธ Like & Comment - Engage with the community
  • ๐Ÿ›ก๏ธ Daily Like Limits - Bot protection with bonus system (2 base + 8 per generation + 10 per purchase)
  • ๐Ÿ“œ Transaction History - Track all platform activity
  • ๐Ÿ”’ Image Protection - Download prevention with overlay shield

Monetization Model

Image Generation Fees:

  • With referrer: 85% treasury + 15% referrer
  • System referral (no ref link): 100% treasury

Image Purchase Splits:

  • With referrer: 80% creator + 10% referrer + 10% treasury
  • System referral (no ref link): 80% creator + 20% treasury
  • Self-purchase: same splits apply

Examples (100 SKR):

  • Generation (with referrer) = 85 SKR treasury + 15 SKR referrer
  • Purchase (with referrer) = 80 SKR creator + 10 SKR referrer + 10 SKR treasury
  • Purchase (system referral) = 80 SKR creator + 20 SKR treasury

Like Bonuses:

  • +8 likes per generated image (to creator)
  • +10 likes per purchased image (to buyer)
  • +10 likes to referrer when their referral generates
  • +15 likes to referrer when their referral purchases
  • +5 likes to referrer per new invited user

System Referral: Users who visit solia.live without a ?ref= code are automatically registered as system referrals (treasury). This means all referrer shares go to the treasury.

Atomic Transactions: Solana guarantees all transfers succeed or all fail - no partial payments

๐Ÿ›  Tech Stack

Frontend

  • React 19 - Modern UI framework with latest features
  • TypeScript - Type-safe development
  • Vite - Lightning-fast build tool
  • Tailwind CSS v4 - Utility-first styling with custom Solana theme
  • Lucide React - Beautiful icon library
  • Motion - Smooth animations

Mobile (Android)

  • Capacitor - Native Android wrapper for Solana Mobile dApp Store
  • Deep Links - Referral handling via https://solia.live/?ref=CODE
  • MWA - Mobile Wallet Adapter support (Phantom, Solflare mobile)

Blockchain

  • Solana Web3.js - Blockchain interactions
  • Jupiter Unified Wallet Kit - Multi-wallet support (Phantom, Solflare, MWA)
  • SPL Token - SKR token operations

Backend & Services

  • Supabase - PostgreSQL database with real-time features
  • AI API - Image generation engine
  • Twitter oEmbed API - Profile verification
  • CoinGecko API - Live crypto prices

๐Ÿ“ฆ Installation

Prerequisites

  • Node.js 18+
  • npm or yarn
  • Solana wallet (Phantom/Solflare)
  • Supabase account
  • AI API credentials

Setup

  1. Clone the repository
git clone https://github.com/kolyantrend/solia.git
cd solia
  1. Install dependencies
npm install
  1. Configure environment variables

Create .env.local from the example file:

cp .env.example .env.local

Edit .env.local:

# Image generation API key
AI_API_KEY=your_ai_api_key

# Supabase Configuration
VITE_SUPABASE_URL=your_supabase_project_url
VITE_SUPABASE_ANON_KEY=your_supabase_anon_key

# Solana RPC (optional - uses public RPC if not set)
VITE_SOLANA_RPC_URL=your_custom_rpc_url
  1. Run development server
npm run dev

Visit the local dev server to start developing.

๐Ÿ—„ Database Schema

Core Tables

Table Description
profiles User profiles (wallet, display_name, twitter, verified, ref_code)
posts AI-generated images (author, image_url, prompt, category, likes_count)
likes User engagement tracking
comments Post discussions
purchases Content purchase records
follows Creator network graph
referrals Referral tracking
transactions Financial history
daily_likes Bot protection system

๐ŸŽจ Key Features Explained

Feed Algorithm

Sort Window Formula Behavior
New All created_at DESC Always fresh, 3min cache
Hot 6 hours (likes+1) / (hours+2)^1.5 Fast rotation, engagement-driven
Trends 24 hours (likes+1) / (hours+4)^1.1 Viral content stays longer

Caching Strategy

  • Profile Cache - 2 min TTL
  • Feed Cache - 3 min TTL (single query for 200 posts, client-side scoring)
  • Stats Cache - 5 min TTL

๐Ÿ“ฑ Mobile Support

  • Solana Mobile Wallet Adapter integration
  • Responsive design for all screen sizes
  • Touch-optimized UI components

๐ŸŒ Internationalization

Supported languages (6):

  • ๐Ÿ‡ฌ๐Ÿ‡ง English (en)
  • ๐Ÿ‡ท๐Ÿ‡บ Russian (ru)
  • ๐Ÿ‡จ๐Ÿ‡ณ Chinese (zh)
  • ๐Ÿ‡ฎ๐Ÿ‡ณ Hindi (hi)
  • ๐Ÿ‡ป๐Ÿ‡ณ Vietnamese (vi)
  • ๐Ÿ‡ฏ๐Ÿ‡ต Japanese (ja)

๐Ÿ”ง Development

Type checking

npm run lint

Project structure

src/
โ”œโ”€โ”€ config/
โ”‚   โ””โ”€โ”€ banners.ts          # Banner & promo banner config
โ”œโ”€โ”€ components/
โ”‚   โ”œโ”€โ”€ Layout.tsx           # App shell with navigation
โ”‚   โ”œโ”€โ”€ BannerCarousel.tsx   # Rotating banners
โ”‚   โ”œโ”€โ”€ CryptoTicker.tsx     # Live crypto prices
โ”‚   โ””โ”€โ”€ TopCreatorsTicker.tsx
โ”œโ”€โ”€ views/
โ”‚   โ”œโ”€โ”€ FeedView.tsx         # Main feed with smart algorithms
โ”‚   โ”œโ”€โ”€ GenerateView.tsx     # AI image generation
โ”‚   โ”œโ”€โ”€ LeaderboardView.tsx  # Top creators ranking
โ”‚   โ”œโ”€โ”€ StatsView.tsx        # Analytics dashboard
โ”‚   โ””โ”€โ”€ ProfileView.tsx      # User profiles
โ”œโ”€โ”€ lib/
โ”‚   โ”œโ”€โ”€ database.ts          # Supabase queries with caching
โ”‚   โ”œโ”€โ”€ solana.ts            # SKR token transfers & config
โ”‚   โ”œโ”€โ”€ supabase.ts          # Supabase client
โ”‚   โ””โ”€โ”€ utils.ts             # Helper functions
โ”œโ”€โ”€ App.tsx                  # Root component
โ”œโ”€โ”€ theme.tsx                # Theme context (dark/light)
โ”œโ”€โ”€ i18n.tsx                 # Internationalization (6 languages)
โ”œโ”€โ”€ likes.ts                 # Like system with bot protection
โ””โ”€โ”€ index.css                # Theme variables & styles

๐Ÿ”’ Security Notes

Protected by .gitignore (never committed):

  • .env.local - API keys & secrets
  • node_modules/ - Dependencies
  • dist/ - Build output
  • IDE config directories

Additional protections:

  • All secrets via environment variables
  • Image download protection (CSS + JS overlay)
  • Daily like limits with bonus system
  • Atomic Solana transactions
  • Referral validation

๐Ÿ“„ License

Proprietary and Confidential

This software is the exclusive property of the Solia team. Unauthorized copying, distribution, modification, or use is strictly prohibited.

๐Ÿ”— Links

๐Ÿ’ก Roadmap

  • Mobile app (Android APK + PWA)
  • Advanced AI models integration (Gemini)
  • MWA wallet support (Phantom, Jupiter, Solflare)
  • Creator subscriptions
  • DAO governance
  • Cross-chain support

Built with โค๏ธ on Solana

About

Solia - a decentralized social platform for AI creators to monetize their content on the Solana blockchain. Create, share, and sell AI-generated images with SKR tokens. Built with React, Vite, and Supabase.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors