@jairodri/huckleberry-cli 1.0.1 → 1.1.0

package/skills/startup-launcher/SKILL.md

@@ -0,0 +1,252 @@
+---
+name: startup-launcher
+description: "Launch a product across 56 platforms — generates all copy, tracks submissions, and guides launch day operations."
+category: growth
+tier: must-have
+reads:
+  - brand/voice-profile.md
+  - brand/positioning.md
+  - brand/audience.md
+  - brand/competitors.md
+writes:
+  - marketing/launch/product-brief.md
+  - marketing/launch/launch-tracker.md
+triggers:
+  - startup launcher
+  - submit to directories
+  - launch on Product Hunt
+  - submit to BetaList
+  - multi-platform launch
+  - launch campaign
+  - directory submissions
+  - AppSumo campaign
+  - Hacker News launch
+  - where should I launch
+  - launch across platforms
+  - submit everywhere
+  - platform submissions
+metadata:
+  version: 1.0.0
+---
+
+# Startup Launcher
+
+You are a launch campaign manager. You assess products once, recommend platform sequences, generate all platform-specific assets, and guide users through submissions across 56 platforms. You operate as a 3-layer system that minimizes user cognitive load while maximizing launch effectiveness.
+
+## On Activation
+
+1. Check if `brand/` directory exists in the project root
+2. If it exists, read `brand/voice-profile.md`, `brand/positioning.md`, `brand/audience.md`, and `brand/competitors.md` for context
+3. Use brand context to pre-fill what you can — only ask for information not already covered
+4. Check if `marketing/launch/product-brief.md` exists — if so, load it and skip the interview
+
+---
+
+## How This Works (3-Layer Architecture)
+
+### Layer 1: Product Brief (One-Time Setup)
+Check for existing `marketing/launch/product-brief.md` in user's workspace. If none exists, run the 5-question interview and generate the brief. All platform copy gets generated FROM this brief.
+
+### Layer 2: Platform Intelligence (On-Demand Reference)
+56 platform files in `references/platforms/` stay as reference. Load them when prepping a specific submission. User never sees or thinks about these files.
+
+### Layer 3: Launch Tracker (Living File)
+Maintain `marketing/launch/launch-tracker.md` in user's workspace. Track which platforms have been submitted to, status of each, copy used, next actions, and dates.
+
+## Step 1: Brief Check & Product Assessment
+
+First action: Does `marketing/launch/product-brief.md` exist? If not, ask these 5 questions:
+
+| # | Question | Why It Matters |
+|---|----------|---------------|
+| 1 | What does it do? (one sentence) | Becomes the seed for all platform copy |
+| 2 | Who is it for? (developers / founders / consumers / enterprise) | Filters which platforms match |
+| 3 | What stage? (pre-launch / just launched / launched with traction) | Determines sequence order |
+| 4 | Budget for paid placements? ($0 / under $150 / under $300+) | Filters paid vs free tiers |
+| 5 | Open source? (yes / no) | Critical for platform classification |
+
+Generate the brief using `references/templates/product-brief.md` and save it to `marketing/launch/product-brief.md`. The brief should include space for: product URL, logo path, screenshot paths, video URL, GitHub repo URL, pricing page URL, founder name/photo, OG image path.
+
+## Step 2: Generate Universal Copy
+
+From the brief, produce these copy blocks and save to the brief file or a companion file:
+
+### Tagline Variants
+- **60 char version:** For Product Hunt (`[Verb] [outcome] for [audience]`)
+- **100 char version:** For most directories
+- **Full sentence version:** For detailed listings
+
+### Description Blocks
+- **Short description:** 1-2 sentences for previews
+- **Medium description:** 1 paragraph for directory pages
+- **Long description:** 3-5 paragraphs with feature bullets for comprehensive listings
+
+### Platform-Specific Content
+- **Maker/founder story:** For first comments on PH/HN
+- **Technical summary:** For dev-focused platforms (DevHunt, Hacker News)
+- **Show HN format:** "Show HN: [Name] - [what it does in plain English]"
+
+## Step 3: Platform Classification & Recommendation
+
+Based on the brief, classify ALL 56 platforms into these categories:
+
+### Immediate (Free, Fast Submission - Do Now)
+Most launch directories and software directories with free tiers. Agent drafts everything, user just submits:
+- **Launch Directories:** BetaList (free), Indie Hackers, Uneed (free), Fazier (free), TinyLaunch, Tiny Startups, SideProjectors, LaunchIgniter (free), PeerPush (free), DevHunt, TrustMRR, Startup Stash, Launching Next, Firsto, LaunchIt, Launch Your App, DesiFounder, Rank In Public, Launchboard, Aura++, TryLaunch, Selected, LaunchFast, Lab Startups, indie.deals
+- **Software Directories:** SaaSHub, OpenAlternative, LibHunt, Toolfolio, SaaS Genius, There's an AI for that, AlternativeTo, SourceForge, Softonic, Crunchbase, HackerNoon, Devpost
+
+### Scheduled (Weekly Cadences or Timing-Sensitive)
+- **Product Hunt:** Daily reset 12:01 AM PST
+- **Peerlist:** Weekly Monday launches
+- **TinyLaunch:** Weekly windows
+- **LaunchIgniter:** Weekly Monday launches
+
+### Premium (Need Dedicated Prep and Strategy)
+These get their own planning sessions:
+- **Product Hunt:** (also in scheduled, but premium prep needed)
+- **Hacker News:** Show HN strategy required
+- **AppSumo:** Full campaign strategy needed
+- **G2:** Enterprise sales focus required
+
+### Revenue (Deal/LTD Platforms - Different Economics)
+Revenue share models, need pricing strategy:
+- **AppSumo, RocketHub, StackSocial, SaaS Mantra, SaaS Warrior, LTD Hunt, KEN Moo, Prime Club, SaaSZilla, SaaS Pirate, Product Canyon, Deal Mirror, Dealify**
+
+### Skip (Doesn't Fit Based on Brief)
+Explain WHY each is skipped (e.g., "OpenAlternative requires open source, your product is proprietary")
+
+## Step 4: Platform Quick Reference Matrix
+
+See `references/platform-matrix.md` for the full 56-platform table with category, cost, best-for, traffic potential, and reference file paths.
+
+**Summary by category:**
+- **29 Launch Directories** — Free/low-cost submission. Agent drafts copy, user clicks submit.
+- **13 Deal/LTD Marketplaces** — Revenue share models. Need pricing strategy.
+- **14 Software Directories** — Free listings for SEO value and discoverability.
+
+## Step 5: Execution Flow
+
+**Key principle:** The agent does the work. Generate all copy, adapt it per platform, create the tracker, and only hand off to the user when a human action is required (clicking submit, uploading images, making a payment).
+
+For each platform the user wants to launch on:
+
+1. **Load the platform file** from `references/platforms/[platform].md`
+2. **Adapt universal copy** to platform-specific requirements
+3. **Generate platform-specific content** (tagline in their format, description at their length)
+4. **Provide exact instructions:** URL to visit, exact fields to fill, exact copy to paste
+5. **Include platform-specific tips** from the reference file
+6. **Update the launch tracker** with status and next actions
+
+When handing off, give: the exact URL, exact fields, and exact copy to paste.
+
+## Step 6: Launch Tracker Management
+
+Maintain `marketing/launch/launch-tracker.md` in the user's workspace with:
+
+- **Platform name, category, status, date submitted, date approved/live, notes**
+- **Next actions with dates**
+- **Summary stats:** X submitted, Y approved, Z live
+- **Status options:** Not Started, Drafting, Submitted, Pending Review, Approved, Live, Skipped, Rejected
+
+Use `references/templates/launch-tracker.md` as the base template, pre-populated with all 56 platforms.
+
+## Step 7: Image/Asset Specifications
+
+Consolidate image specs across all platforms into one reference for user preparation:
+
+### Universal Asset Requirements
+| Asset Type | Size | Format | Notes |
+|------------|------|--------|-------|
+| **Logo** | Square (500x500px+) | PNG transparent | Readable at 40px |
+| **Screenshots** | 1920x1080px+ | PNG/JPG | 3-5 images, real UI |
+| **OG Image** | 1200x630px | PNG/JPG | Social media preview |
+| **Demo Video** | Any | MP4 | 30-90 seconds |
+
+### Platform-Specific Requirements
+| Platform | Logo | Screenshots | Cover/OG | Max File Size |
+|----------|------|-------------|----------|---------------|
+| Product Hunt | 240x240+ square | 1270x952px or 2400x1260px | N/A | <500KB each |
+| Hacker News | N/A | N/A (link to live demo) | N/A | N/A |
+| BetaList | Square | 1200x750px recommended | Landing screenshot IS preview | Standard |
+| Peerlist | Square (personal photo) | Fill ALL slots | 1200x630px cover | Standard |
+| Most directories | Square | 2-3 minimum | 1200x630px OG image | 5MB typical |
+
+This lets the user prepare assets ONCE for all platforms.
+
+## Step 8: Launch Day Operations
+
+Condensed playbooks for platforms where launch day is a live event:
+
+### Product Hunt Launch Day Timeline
+- **12:01 AM PST:** Go live, post maker comment immediately (with GIF)
+- **First 2 hours:** Check if featured (homepage vs "All" tab)
+- **Hours 0-4:** First wave outreach (EU/Asia supporters)
+- **Hours 4-8:** Second wave (US East Coast), LinkedIn post
+- **Hours 8-12:** Third wave (US West Coast), final community push
+- **All day:** Reply to every comment within 5-10 minutes
+- **Key rule:** Ask for "feedback" or "support," never "upvotes"
+
+### Hacker News Launch Day Timeline
+- **Post timing:** Sunday ~12:00 UTC or weekday 11:00-14:00 UTC
+- **Immediately:** Post pre-written technical first comment
+- **First 3-4 hours:** Be at keyboard, reply with technical depth
+- **Watch ratio:** Comments exceeding upvotes at 40+ = controversy penalty
+- **Never ask for upvotes** (HN detects coordination from 5-6 accounts)
+
+### Weekly Platform Engagement (Peerlist, TinyLaunch, LaunchIgniter, PeerPush)
+- **Engage with other launches** in your weekly batch (reciprocity)
+- **Post 2-3 updates** during the week (don't launch and leave)
+- **Respond to all comments** within 24 hours
+- **Share launch link** on social media and relevant communities
+
+## File Router Reference
+
+When prepping a specific platform submission, load the reference file from `references/platforms/[platform].md`. See `references/file-router.md` for the full platform-to-file mapping table (56 entries).
+
+Each reference file contains exact submission requirements, strategy tips, hard rules that cause rejection, and pre/post-launch checklists.
+
+## Cross-Platform Timing & Coordination
+
+Factor these cadences into launch sequencing:
+
+| Platform | Cadence | Lead Time | Notes |
+|----------|---------|-----------|-------|
+| Product Hunt | Daily reset 12:01 AM PST | Schedule in advance | 30+ day account history recommended |
+| Hacker News | Anytime | Immediate | Best: Sunday 12:00 UTC or weekday 11-14 UTC |
+| BetaList (free) | Rolling queue | ~2 month wait | Alternative: priority for $99 |
+| Peerlist | Weekly (Monday launches) | Schedule specific Monday | Dev community focus |
+| TinyLaunch | Weekly windows | Submit before window | Indie maker focus |
+| LaunchIgniter | Weekly (Monday 00:00 UTC) | Choose launch week | SaaS/AI focus |
+| Uneed (free) | Rolling queue | Weeks-months wait | Alternative: paid for $30 |
+| All others | Rolling review | Hours-days | Minimal wait times |
+
+**SEO Value Note:** Submitting to all platforms generates 28+ dofollow backlinks from DR 48-90+ domains. Even with zero traffic, the backlink portfolio is worth hundreds of dollars in SEO value.
+
+## Anti-Patterns
+
+| Anti-Pattern | Why It Fails | Instead |
+|-------------|-------------|---------|
+| Launching on all 56 platforms simultaneously | Spreads attention too thin, can't engage with comments, support collapses | Sequence in waves: Immediate (free, fast) first, then Scheduled, then Premium |
+| Using marketing language on Hacker News | HN detects and punishes marketing speak — gets flagged, downvoted, killed | Write factually. "Show HN: [Name] - [plain description]". No superlatives. |
+| Submitting before product is ready | AppSumo tests your product, PH users try it immediately — bugs = negative reviews that persist | Ensure the product is stable, demo works without signup, pricing is transparent |
+| Asking for upvotes on any platform | PH detects coordination from 5-6 accounts, HN bans for it | Ask for "feedback" or "support", never "upvotes" |
+| Ignoring platform cadences | Launching on PH mid-week when competition is highest, missing Peerlist's Monday window | Check the Cross-Platform Timing table and schedule around each platform's cadence |
+| Same copy on every platform | Each platform has different audiences, norms, and formats | Generate platform-specific copy from the universal brief — adapt, don't copy |
+| Launching without a support plan | AppSumo expects 100-1,300+ tickets month one, PH expects comment replies in 5-10 min | Staff up before launch. Response templates, FAQ, live chat for deal platforms |
+
+## Failure Handling
+
+- **Submission rejected**: Check the platform's reference file for hard rules and gotchas. Fix the issue, then resubmit. If rejected twice, mark as "Skipped" with reason in the tracker.
+- **Platform process changed**: Flag to the user. Check the reference file's freshness (many have "Last researched" dates). Offer to research the current process via web search.
+- **User wants only specific platforms**: Skip the full classification in Step 3. Load only the requested platform reference files and generate copy for those. Still update the tracker for the selected platforms.
+- **Product not ready**: Recommend the user address readiness gaps first. Point them to the asset checklist (`references/templates/asset-checklist.md`) and suggest a timeline for prep before launch.
+
+## Related Skills
+
+- **launch-strategy**: High-level launch phasing (ORB framework, 5-phase approach) — use for strategic planning before this skill
+- **email-sequences**: For launch and onboarding email sequences
+- **page-cro**: For optimizing launch landing pages
+- **direct-response-copy**: For refining platform copy
+- **social-campaign**: For coordinating social posts around launch days
+- **marketing-psychology**: For psychology behind waitlists and exclusivity
+- **competitor-alternatives**: For comparison pages mentioned in post-launch

package/skills/startup-launcher/references/file-router.md

@@ -0,0 +1,64 @@
+# Platform File Router
+
+When prepping a specific platform submission, load the corresponding reference file from `references/platforms/`.
+
+| Platform | Reference File |
+|----------|----------------|
+| Product Hunt | `references/platforms/producthunt.md` |
+| AppSumo | `references/platforms/appsumo.md` |
+| Hacker News | `references/platforms/hackernews.md` |
+| BetaList | `references/platforms/betalist.md` |
+| Indie Hackers | `references/platforms/indiehackers.md` |
+| G2 | `references/platforms/g2.md` |
+| DevHunt | `references/platforms/devhunt.md` |
+| Uneed | `references/platforms/uneed.md` |
+| Fazier | `references/platforms/fazier.md` |
+| MicroLaunch | `references/platforms/microlaunch.md` |
+| Peerlist | `references/platforms/peerlist.md` |
+| TinyLaunch | `references/platforms/tinylaunch.md` |
+| Tiny Startups | `references/platforms/tinystartups.md` |
+| SideProjectors | `references/platforms/sideprojectors.md` |
+| LaunchIgniter | `references/platforms/launchigniter.md` |
+| PeerPush | `references/platforms/peerpush.md` |
+| TrustMRR | `references/platforms/trustmrr.md` |
+| Aura++ | `references/platforms/auraplusplus.md` |
+| DesiFounder | `references/platforms/desifounder.md` |
+| Firsto | `references/platforms/firsto.md` |
+| indie.deals | `references/platforms/indiedeals.md` |
+| Lab Startups | `references/platforms/labstartups.md` |
+| Launchboard | `references/platforms/launchboard.md` |
+| LaunchFast | `references/platforms/launchfast.md` |
+| LaunchIt | `references/platforms/launchit.md` |
+| Launch Your App | `references/platforms/launchyourapp.md` |
+| Launching Next | `references/platforms/launchingnext.md` |
+| Rank In Public | `references/platforms/rankinpublic.md` |
+| Selected | `references/platforms/selected.md` |
+| Startup Stash | `references/platforms/startupstash.md` |
+| TryLaunch | `references/platforms/trylaunch.md` |
+| SaaSHub | `references/platforms/saashub.md` |
+| Capterra | `references/platforms/capterra.md` |
+| OpenAlternative | `references/platforms/openalternative.md` |
+| LibHunt | `references/platforms/libhunt.md` |
+| Toolfolio | `references/platforms/toolfolio.md` |
+| SaaS Genius | `references/platforms/saasgenius.md` |
+| There's an AI for that | `references/platforms/theresanaiforthat.md` |
+| AlternativeTo | `references/platforms/alternativeto.md` |
+| SourceForge | `references/platforms/sourceforge.md` |
+| Softonic | `references/platforms/softonic.md` |
+| Crunchbase | `references/platforms/crunchbase.md` |
+| HackerNoon | `references/platforms/hackernoon.md` |
+| Devpost | `references/platforms/devpost.md` |
+| RocketHub | `references/platforms/rockethub.md` |
+| StackSocial | `references/platforms/stacksocial.md` |
+| SaaS Mantra | `references/platforms/saasmantra.md` |
+| SaaS Warrior | `references/platforms/saaswarrior.md` |
+| LTD Hunt | `references/platforms/ltdhunt.md` |
+| KEN Moo | `references/platforms/kenmoo.md` |
+| Prime Club | `references/platforms/primeclub.md` |
+| SaaSZilla | `references/platforms/saaszilla.md` |
+| SaaS Pirate | `references/platforms/saaspirate.md` |
+| Product Canyon | `references/platforms/productcanyon.md` |
+| Deal Mirror | `references/platforms/dealmirror.md` |
+| Dealify | `references/platforms/dealify.md` |
+
+Each file contains exact submission requirements, strategy tips, hard rules that cause rejection, and pre/post-launch checklists.

package/skills/startup-launcher/references/platform-matrix.md

@@ -0,0 +1,65 @@
+# Platform Quick Reference Matrix
+
+Use this table during Step 3 (Platform Classification) and Step 5 (Execution Flow) to look up platform details.
+
+| Platform | Category | Cost | Best For | Traffic Potential | File |
+|----------|----------|------|----------|-------------------|------|
+| **LAUNCH DIRECTORIES (29)** |
+| Product Hunt | Directory | Free | SaaS, consumer apps, visual products | 5K-25K visitors | `producthunt.md` |
+| Hacker News | Directory | Free | Dev tools, OSS, technical products | 10K-30K visitors | `hackernews.md` |
+| BetaList | Directory | $0/$99 | Pre-launch validation, waitlist building | 50-500 signups | `betalist.md` |
+| Indie Hackers | Directory | Free | Bootstrapped SaaS, founder stories | High-intent, slow burn | `indiehackers.md` |
+| Uneed | Directory | $0/$30 | Indie tools, SaaS | 200-2K visitors | `uneed.md` |
+| Fazier | Directory | $0/$79 | Indie makers, founders | Low traffic, high SEO | `fazier.md` |
+| MicroLaunch | Directory | $0/$49 | Side projects, MVPs | Moderate | `microlaunch.md` |
+| Peerlist | Directory | Free | Dev tools, OSS, portfolios | Moderate, high quality | `peerlist.md` |
+| TinyLaunch | Directory | $0/$39 | Indie makers, first launches | Low-moderate | `tinylaunch.md` |
+| Tiny Startups | Directory | Free | Bootstrapped products | Newsletter: 20K subs | `tinystartups.md` |
+| SideProjectors | Directory | Free | Side projects, showcases | 250K pageviews/mo | `sideprojectors.md` |
+| LaunchIgniter | Directory | $0/$12 | SaaS, AI tools | 50-300 clicks | `launchigniter.md` |
+| PeerPush | Directory | $0/paid | Builder tools, SaaS | 250K visitors/mo | `peerpush.md` |
+| DevHunt | Directory | Free | Developer tools, OSS | Growing dev community | `devhunt.md` |
+| TrustMRR | Directory | Free | SaaS, recurring revenue | Moderate | `trustmrr.md` |
+| Startup Stash | Directory | Free | Startup resources, tools | Moderate | `startupstash.md` |
+| Launching Next | Directory | Free | Early-stage startups | Moderate | `launchingnext.md` |
+| Firsto | Directory | Free | New product launches | Moderate | `firsto.md` |
+| LaunchIt | Directory | Free | Launch announcements | Moderate | `launchit.md` |
+| Launch Your App | Directory | Free | Mobile app launches | Moderate | `launchyourapp.md` |
+| DesiFounder | Directory | Free | Indian founder community | Moderate | `desifounder.md` |
+| Rank In Public | Directory | Free | Public building, startups | Moderate | `rankinpublic.md` |
+| Launchboard | Directory | Free | Launch discovery | Moderate | `launchboard.md` |
+| Aura++ | Directory | Free | Creator tools, SaaS | Moderate | `auraplusplus.md` |
+| TryLaunch | Directory | Free | Product trials, launches | Moderate | `trylaunch.md` |
+| Selected | Directory | Free | Curated product launches | Moderate | `selected.md` |
+| LaunchFast | Directory | Free | Quick launch submissions | Moderate | `launchfast.md` |
+| Lab Startups | Directory | Free | Experimental projects | Moderate | `labstartups.md` |
+| indie.deals | Directory | Free | Indie product deals | Moderate | `indiedeals.md` |
+| **DEAL/LTD MARKETPLACES (13)** |
+| AppSumo | Deal | Revenue share | SaaS, productivity tools | $40K-$400K campaigns | `appsumo.md` |
+| RocketHub | Deal | Revenue share | Software deals | Moderate | `rockethub.md` |
+| StackSocial | Deal | Revenue share | Tech products | High volume | `stacksocial.md` |
+| SaaS Mantra | Deal | Revenue share | SaaS lifetime deals | Growing | `saasmantra.md` |
+| SaaS Warrior | Deal | Revenue share | SaaS tools | Moderate | `saaswarrior.md` |
+| LTD Hunt | Deal | Revenue share | Lifetime deals | Moderate | `ltdhunt.md` |
+| KEN Moo | Deal | Revenue share | Software deals | Moderate | `kenmoo.md` |
+| Prime Club | Deal | Revenue share | Premium deals | Moderate | `primeclub.md` |
+| SaaSZilla | Deal | Revenue share | SaaS deals | Moderate | `saaszilla.md` |
+| SaaS Pirate | Deal | Revenue share | SaaS lifetime deals | Moderate | `saaspirate.md` |
+| Product Canyon | Deal | Revenue share | Product deals | Moderate | `productcanyon.md` |
+| Deal Mirror | Deal | Revenue share | Software deals | Moderate | `dealmirror.md` |
+| Dealify | Deal | Revenue share | Deal marketplace | Moderate | `dealify.md` |
+| **SOFTWARE DIRECTORIES (14)** |
+| SaaSHub | Directory | Free | SaaS discovery | High SEO value | `saashub.md` |
+| G2 | Directory | Free | Enterprise software | High-intent buyers | `g2.md` |
+| Capterra | Directory | Free | Business software | High commercial intent | `capterra.md` |
+| OpenAlternative | Directory | Free | Open source alternatives | Developer audience | `openalternative.md` |
+| LibHunt | Directory | Free | Libraries, frameworks | Developer tools | `libhunt.md` |
+| Toolfolio | Directory | Free | Tool discovery | Moderate | `toolfolio.md` |
+| SaaS Genius | Directory | Free | SaaS tools | Moderate | `saasgenius.md` |
+| There's an AI for that | Directory | Free | AI tools | AI-focused audience | `theresanaiforthat.md` |
+| AlternativeTo | Directory | Free | Software alternatives | High traffic | `alternativeto.md` |
+| SourceForge | Directory | Free | Open source projects | Developer audience | `sourceforge.md` |
+| Softonic | Directory | Free | Software downloads | Consumer software | `softonic.md` |
+| Crunchbase | Directory | Free | Startup database | High authority, investors | `crunchbase.md` |
+| HackerNoon | Directory | Free | Tech publishing | Developer audience | `hackernoon.md` |
+| Devpost | Directory | Free | Developer projects | Hackathon, dev showcase | `devpost.md` |

package/skills/startup-launcher/references/platforms/alternativeto.md

@@ -0,0 +1,283 @@
+# AlternativeTo Launch Platform Guide
+
+## 1. Platform Overview
+
+**AlternativeTo** is a crowdsourced platform that helps users discover alternatives to existing software and apps. Founded as a community-driven directory, it serves as the go-to destination for people looking to replace or find competitors to existing tools.
+
+- **URL:** [alternativeto.net](https://alternativeto.net)
+- **Category:** Software discovery and comparison platform
+- **Founded:** 2009
+- **Type:** Community-driven, moderated submission platform
+- **Primary Function:** Connecting users with alternative software solutions across all categories
+
+The platform operates on a simple premise: when users search for "alternatives to [software name]," AlternativeTo appears prominently in search results, making it a powerful organic discovery channel for startups.
+
+## 2. Key Stats
+
+- **Global Ranking:** #22,348 globally, #405 in Programming and Developer Software category (January 2026)
+- **Monthly Visitors:** ~1 million monthly visitors
+- **Traffic Sources:** 63.63% from organic search, followed by direct traffic and referrals
+- **Domain Authority:** High (consistently ranks in top search results for alternative queries)
+- **Pricing:** Free submissions
+- **Geography:** Global audience with strong presence in developer and tech communities
+- **User Intent:** High-intent traffic specifically looking for software alternatives
+
+## 3. Who Should Use This
+
+**Perfect for:**
+- **SaaS startups** positioned as alternatives to existing tools
+- **Software products** with clear competitive positioning
+- **Developer tools** and programming software
+- **Productivity apps** competing with established players
+- **Open-source projects** offering alternatives to proprietary software
+- **Niche tools** that solve specific problems better than incumbents
+
+**Especially effective if:**
+- Your product is a direct competitor or alternative to a well-known tool
+- You offer a free or more affordable version of existing paid software
+- You have unique features that differentiate from competitors
+- Your product targets developers, tech professionals, or productivity users
+
+**Less suitable for:**
+- Completely novel products with no clear alternatives
+- Consumer apps without technical focus
+- Products still in very early development
+- Services rather than software tools
+
+## 4. Submission Process
+
+### Step-by-Step Submission:
+
+1. **Create Account**
+   - Visit [alternativeto.net](https://alternativeto.net)
+   - Click "Sign up" in top right corner
+   - Complete simple registration process
+
+2. **Access Submission Form**
+   - Log in and click on your User icon (top right)
+   - Select "Suggest new application" from dropdown menu
+
+3. **Complete 4-Step Form:**
+
+   **Step 1: Name and Main Purpose**
+   - Enter your application name
+   - Write a clear, concise description of what your software does
+   - Focus on the primary problem it solves
+
+   **Step 2: Grab Data from External Sources**
+   - Optional step for apps listed in Mac/iOS app stores
+   - Skip if not applicable to your product
+
+   **Step 3: Main Data (Critical Section)**
+   - **Platforms:** Select all platforms your software supports
+   - **License:** Choose appropriate license type (Free, Freemium, Paid, Open Source)
+   - **Price:** Enter accurate pricing information
+   - **Tags:** Add generous, relevant tags (these drive internal discovery)
+   - **Description:** Detailed explanation of features and benefits
+   - **Screenshots/Images:** Upload high-quality visuals
+
+   **Step 4: Suggest Alternatives**
+   - List apps your software is an alternative to
+   - Be generous with suggestions to increase internal cross-references
+   - This step is crucial for discovery and ranking
+
+4. **Submit for Review**
+   - Review all information for accuracy
+   - Submit application for moderation approval
+   - Typical approval time: 1-2 days
+
+## 5. Requirements
+
+### Essential Requirements:
+- **Product name** (clear, professional)
+- **Detailed description** (what it does, who it's for)
+- **Accurate pricing** information
+- **Platform compatibility** (Windows, Mac, Linux, Web, Mobile)
+- **License type** (Free, Paid, Open Source, Freemium)
+- **Official website** URL
+
+### Recommended Assets:
+- **Logo/Icon:** Professional, high-resolution logo
+- **Screenshots:** 2-3 high-quality product screenshots
+- **Feature list:** Clear list of key capabilities
+- **Alternatives list:** Comprehensive list of competing products
+- **Tags:** Relevant category and feature tags
+- **Social links:** Links to GitHub, Twitter, etc. (if applicable)
+
+### Quality Standards:
+- Professional presentation (no obvious typos or low-quality images)
+- Functional product (not just concepts or coming soon pages)
+- Legitimate business/project (no spam or misleading claims)
+- Accurate information (pricing, features, availability)
+
+## 6. Strategy & Tips
+
+### Optimization Strategies:
+
+**Maximize Tag Usage:**
+- Use all relevant tags - they drive internal discovery
+- Include feature-based tags (e.g., "collaboration," "real-time," "API")
+- Add category tags (e.g., "project management," "design," "analytics")
+- Don't overstuff with irrelevant tags
+
+**Alternative Mapping:**
+- List ALL legitimate competitors, not just major ones
+- Include both direct and indirect alternatives
+- Add open-source alternatives if your product is commercial
+- Be generous - more alternatives = more cross-references = better visibility
+
+**Description Best Practices:**
+- Lead with your unique value proposition
+- Mention key differentiators from alternatives
+- Include specific use cases and target audience
+- Keep it scannable with clear benefits
+- Avoid marketing fluff - focus on functionality
+
+**Timing Strategy:**
+- Submit after you have a functional product (not during development)
+- Best to submit alongside other directory submissions for compound effect
+- No specific timing advantages - consistent discovery over time
+
+### Post-Submission Tactics:
+
+**Continuous Improvement:**
+- Regularly add newly discovered alternatives using the "add alternative" link
+- Update your listing when you add major features
+- Monitor and respond to user comments/reviews
+- Keep pricing and platform information current
+
+**Community Engagement:**
+- Respond professionally to any user feedback
+- Engage with users who comment on your listing
+- Consider featuring your AlternativeTo listing in other marketing
+
+## 7. Tips & Tricks from the Community
+
+**From Founder Experiences:**
+
+**Cross-Platform Strategy:**
+- Developers recommend submitting to AlternativeTo as part of a broader directory campaign
+- Combine with Product Hunt, Beta List, and other startup directories for maximum impact
+- The compound effect of multiple listings increases overall discovery
+
+**Long-term Value:**
+- Unlike Product Hunt's one-day exposure, AlternativeTo provides ongoing traffic
+- Many founders report steady, consistent traffic months after initial submission
+- The SEO benefits build over time as the listing gains authority
+
+**Competitive Intelligence:**
+- Use AlternativeTo to research your competition before submitting
+- Study how successful competitors position themselves
+- Look at their tags and alternatives lists for insights
+
+**Content Strategy:**
+- Several founders note that detailed, honest descriptions perform better than sales copy
+- Including limitations or specific use cases builds trust
+- Screenshots showing actual functionality outperform marketing images
+
+**Organic Discovery:**
+- The platform excels at capturing users actively seeking alternatives
+- Traffic is typically high-intent and converts well
+- Focus on clear positioning against existing alternatives
+
+## 8. Common Mistakes / Gotchas
+
+### Submission Rejections:
+- **Incomplete information:** Missing key details like pricing or platform support
+- **Poor quality assets:** Low-resolution logos or unprofessional screenshots
+- **Misleading descriptions:** Overpromising features or inaccurate claims
+- **Too early submission:** Products still in development without functional demos
+- **Duplicate submissions:** Multiple listings for the same product
+
+### Post-Submission Issues:
+- **Insufficient alternatives mapping:** Missing obvious competitors limits cross-discovery
+- **Outdated information:** Not updating pricing, features, or availability
+- **Ignoring user feedback:** Not responding to legitimate user comments or questions
+- **Tag stuffing:** Using irrelevant tags that don't match your product
+
+### Strategic Errors:
+- **One-and-done approach:** Submitting and forgetting, rather than maintaining the listing
+- **Poor positioning:** Not clearly articulating what makes your product different
+- **Generic descriptions:** Using the same description as on your website rather than optimizing for alternative-seekers
+
+### Technical Issues:
+- **Website availability:** Ensure your website is accessible when submitted for review
+- **Broken links:** Verify all submitted URLs are functional
+- **Regional restrictions:** Not noting geographic limitations of your software
+
+## 9. Pre-Launch Checklist
+
+### Product Readiness:
+- [ ] Product is functional and publicly accessible
+- [ ] Website is live and professional
+- [ ] Clear pricing structure is established
+- [ ] Product supports claimed platforms
+- [ ] Features match planned descriptions
+
+### Asset Preparation:
+- [ ] High-resolution logo/icon ready (square format recommended)
+- [ ] 2-3 high-quality screenshots prepared
+- [ ] Professional product description written
+- [ ] Feature list compiled
+- [ ] Pricing information confirmed
+
+### Competitive Research:
+- [ ] Research existing alternatives already listed
+- [ ] Identify your unique positioning vs. competitors
+- [ ] Compile comprehensive list of products you're alternative to
+- [ ] Study successful listings in your category for inspiration
+- [ ] Prepare relevant tags based on competitor analysis
+
+### Account Setup:
+- [ ] Create AlternativeTo account with professional email
+- [ ] Verify email address and complete profile
+- [ ] Test submission process with draft information
+
+### Content Optimization:
+- [ ] Write alternative-focused description (not generic marketing copy)
+- [ ] Identify all relevant category and feature tags
+- [ ] Prepare list of platforms and license type
+- [ ] Draft response templates for potential user questions
+
+## 10. Post-Launch Checklist
+
+### Immediate Follow-up (Within 48 hours):
+- [ ] Verify listing is live and displays correctly
+- [ ] Check all links and information for accuracy
+- [ ] Save listing URL for future reference and promotion
+- [ ] Share listing with team for feedback
+
+### First Week:
+- [ ] Add any missed alternatives using "add alternative" feature
+- [ ] Monitor for any user comments or feedback
+- [ ] Update any information that needs correction
+- [ ] Include AlternativeTo listing in other marketing materials
+
+### Ongoing Maintenance (Monthly):
+- [ ] Check for new alternatives to add to your listing
+- [ ] Update pricing or feature information if changed
+- [ ] Monitor user comments and respond professionally
+- [ ] Track traffic from AlternativeTo in analytics
+- [ ] Add new platform support if applicable
+
+### Performance Monitoring:
+- [ ] Set up Google Analytics tracking for AlternativeTo traffic
+- [ ] Monitor search ranking for "[product] alternatives" queries
+- [ ] Track conversion rates from AlternativeTo visitors
+- [ ] Document referral traffic patterns
+
+### Community Engagement:
+- [ ] Respond to any user reviews or comments within 24 hours
+- [ ] Engage with users who mention your product in discussions
+- [ ] Consider featuring positive user feedback in other marketing
+- [ ] Build relationships with users who become advocates
+
+### Strategic Development:
+- [ ] Analyze which alternatives drive the most cross-traffic
+- [ ] Use insights to improve competitive positioning
+- [ ] Consider content marketing around alternative comparisons
+- [ ] Leverage AlternativeTo insights for Product Hunt and other launches
+
+---
+
+**Bottom Line:** AlternativeTo excels at generating targeted, high-intent traffic over the long haul. Unlike one-day launch platforms, it builds consistent organic discovery for products positioned as alternatives to existing solutions. The key to success is thorough preparation, generous alternative mapping, and ongoing maintenance of your listing.