Payment providers: Configure one or both. If both are set, users can choose between crypto and card. If neither is set, paid features run in demo mode (applied free).

Deploy to Vercel

1. Create a Turso Database

# Install Turso CLI
curl -sSfL https://get.tur.so/install.sh | bash
Sign up / login
turso auth signup
Create database
turso db create memescope-monday
Get the URL
turso db show memescope-monday --url
Create auth token
turso db tokens create memescope-monday

2. Deploy

# Install Vercel CLI
npm i -g vercel
Deploy
vercel
Set environment variables
vercel env add TURSODATABASEURL
vercel env add TURSOAUTHTOKEN
Deploy to production
vercel --prod

Or connect the GitHub repo to Vercel and add the env vars in the Vercel dashboard.

One-Click Deploy

Project Structure

src/
├── app/
│   ├── page.tsx                    # Homepage (countdown, featured, trending, upcoming)
│   ├── coins/
│   │   ├── page.tsx                # Browse directory (search, filter, sort)
│   │   └── [slug]/page.tsx         # Coin detail (chart, market data, scores, chat)
│   ├── submit/page.tsx             # Submit form (auto-fill, paid features)
│   ├── login/page.tsx              # Sign in
│   ├── register/page.tsx           # Create account
│   ├── profile/page.tsx            # User profile
│   ├── watchlist/page.tsx          # Saved coins
│   └── api/
│       ├── auth/                   # Register, login, logout, me
│       ├── coins/                  # List, upvote, chat
│       ├── watchlist/              # Add, remove, check
│       ├── submit/                 # Submit new coin
│       ├── checkout/               # Paid features
│       ├── news/                   # News proxy
│       └── token-data/             # DexScreener proxy
├── components/
│   ├── Header.tsx                  # Nav with auth state
│   ├── Footer.tsx                  # Footer
│   ├── CoinCard.tsx                # Coin listing card with upvotes
│   ├── UpvoteButton.tsx            # Auth-gated voting
│   ├── WatchlistButton.tsx         # Save to watchlist
│   ├── ChartEmbed.tsx              # DexScreener iframe
│   ├── MarketData.tsx              # Live price/volume/liquidity
│   ├── SafetyScore.tsx             # A-F safety grade
│   ├── SocialBuzz.tsx              # Hype level indicator
│   ├── NewsFeed.tsx                # Per-coin news
│   ├── CoinChat.tsx                # Trollbox
│   ├── CountdownTimer.tsx          # Monday 10 AM UTC countdown
│   ├── LaunchCountdown.tsx         # Upcoming launch timer
│   ├── AutoFillAddress.tsx         # Contract address auto-fill
│   ├── PaidFeatures.tsx            # Expedited/trending purchase
│   ├── SubmitForm.tsx              # Full submit form
│   ├── SearchBar.tsx               # Search input
│   ├── ChainFilter.tsx             # Chain filter pills
│   ├── SortSelect.tsx              # Sort dropdown
│   ├── ChainBadge.tsx              # Chain label badge
│   └── AuthProvider.tsx            # Auth context
└── lib/
    ├── db/
    │   ├── schema.ts               # Drizzle schema (6 tables)
    │   ├── index.ts                # DB connection (Turso/local)
    │   └── seed.ts                 # Seed data
    ├── data.ts                     # All database queries
    ├── auth.ts                     # Auth (register, login, sessions)
    ├── types.ts                    # TypeScript types + constants
    ├── utils.ts                    # Utilities
    ├── dexscreener.ts              # DexScreener API client
    ├── news.ts                     # News feed service
    └── scoring.ts                  # Safety score + social buzz algorithms

Database Schema

| Table | Purpose | |-------|---------| | users | Email, username, bcrypt password hash | | sessions | Token-based auth, 30-day expiry | | coins | All listings with full metadata | | votes | One vote per user per coin | | watchlist | Per-user saved coins | | chat_messages | Per-coin trollbox messages |

12 indexes for search and filter performance.

API Routes

| Method | Route | Auth | Description | |--------|-------|------|-------------| | POST | /api/auth/register | No | Create account | | POST | /api/auth/login | No | Sign in | | POST | /api/auth/logout | Yes | Sign out | | GET | /api/auth/me | Yes | Get current user | | GET | /api/coins | No | List coins (filter by chain, search) | | POST | /api/coins/[slug]/upvote | Yes | Upvote a coin | | GET | /api/coins/[slug]/chat | No | Get chat messages | | POST | /api/coins/[slug]/chat | No | Send chat message (username used if logged in) | | POST | /api/submit | No | Submit a new coin | | GET | /api/checkout | No | List available payment providers | | POST | /api/checkout | No | Create checkout (NOWPayments / Stripe / demo) | | POST | /api/webhooks/nowpayments | No | NOWPayments IPN callback | | POST | /api/webhooks/stripe | No | Stripe webhook callback | | GET | /api/watchlist | Yes | Get user's watchlist | | POST | /api/watchlist | Yes | Add/remove from watchlist | | GET | /api/watchlist/check | Yes | Check if coin is in watchlist | | GET | /api/news?q= | No | Fetch coin news | | GET | /api/token-data?address= | No | Fetch market data from DexScreener |

Integrations

DexScreener

• Solana → solana
• Base → base
• BNB Chain → bsc

free-crypto-news