# Sellular - Complete Reference

> Boost your SaaS visibility with AI-powered SEO, directory listings, and discoverability tools.

Website: https://sellular.online

Repository: https://github.com/muammar-yacoob/Sellular
Support: hello@sellular.online

---

## What Sellular Does

Sellular is an AI-powered SEO and visibility toolkit for SaaS founders. It generates directory submission kits, OG cards, SEO files (llms.txt, robots.txt, security.txt), and AI-crafted launch copy for Product Hunt, Hacker News, Reddit, and Twitter/X.

The platform includes a product dashboard where users save their SaaS details, a visibility wizard that generates submission-ready copy for 30+ startup directories, an OG card generator with live preview and downloadable kit, and IndexNow integration for instant search engine indexing.

Built with Next.js 15, Neon PostgreSQL, and Groq AI. Deployed on Vercel.

---

## Feature Details

### 1. Directory listings: submit to 100+ curated directories with one-click profiles

### 2. AI-tailored profiles: generate optimized titles, descriptions, and taglines per directory

### 3. OG image cards: auto-generate branded Open Graph cards with live preview and downloadable kit

### 4. SEO audit: actionable scores, meta checks, and improvement tips for your site

### 5. Email outreach: send directory owner emails with ready-made, customizable templates

### 6. Task checklists: track your launch progress step-by-step with built-in task management

### 7. llms.txt and robots.txt generator: AI-friendly files so LLMs and crawlers discover your product

### 8. Analytics dashboard: track submissions, traffic, and growth with real-time metrics

### 9. SEO file toolkit: generate JSON-LD, sitemap, security.txt, opensearch.xml, and manifest.json

---

## Tech Stack

- Next.js 15 (App Router)
- React 19
- TypeScript
- Bun
- Neon PostgreSQL
- NextAuth v5
- Tailwind CSS
- Biome
- Vercel

---

## Quick Start

### Clone and Install

```bash
git clone https://github.com/muammar-yacoob/Sellular
cd Sellular
cp .env.example .env.local
bun install
```

### Configure Environment

Required environment variables:
- `NEXT_PUBLIC_APP_URL` - Your production URL
- `GOOGLE_CLIENT_ID` / `GOOGLE_CLIENT_SECRET` - Google OAuth credentials
- `DATABASE_URL` - Neon PostgreSQL connection string
- `NEXTAUTH_SECRET` - Random secret for session encryption
- `ALLOWED_EMAILS` - Comma-separated email whitelist

### Push Database Schema

```bash
bun db:push
```

### Run Development Server

```bash
bun dev
```

---

## Project Structure

```
app/
  _components/       Shared UI, layout, hooks, animations
  api/auth/          NextAuth route handler
  dashboard/         Protected dashboard (requires sign-in)
  contact/           Contact form page
  privacy/           Privacy policy
  terms/             Terms of service
lib/
  auth/              NextAuth v5 config
  db/                Drizzle ORM schema and connection
  config/            Site-wide configuration
  seo/               SEO configuration
  utils/             Crypto, currency, slug, format, rate-limiter
```

---

## Pricing

### Free
- Full access to visibility tools. No credit card required.

---

## Why Sellular

### visibility toolkit

Sellular is the all-in-one SaaS visibility toolkit that combines AI-tailored directory profiles, OG card generation, SEO audits, email outreach, and launch checklists in a single free dashboard.

### launch platform

Sellular helps indie founders get discovered after launch with 30+ directory submissions, community connections, visitor analytics, and push notifications.

---

## Supported Platforms

- Hosting: Vercel (recommended), any Node.js/Bun host
- Database: Neon PostgreSQL (recommended), any PostgreSQL provider
- Auth: Google OAuth (extensible to other providers)
- Runtime: Bun (recommended), Node.js 20+
- Package manager: Bun
- OS: Linux, macOS, Windows (WSL)

---

## Security

- Authentication via NextAuth v5 with CSRF protection
- Email whitelist restricts dashboard access
- Rate-limited contact form
- Session tokens stored as HTTP-only cookies
- All database queries via parameterized Drizzle ORM
- No tracking or advertising cookies

---

## Contact

- Support: hello@sellular.online
- Website: https://sellular.online
- Repository: https://github.com/muammar-yacoob/Sellular