# Firsto

A product launch platform where every product deserves to be seen. We provide a space for makers to showcase their products, get feedback, and connect with users.

## Site Overview
- Users submit product launches to showcase their work to the community.
- Products compete for top positions to win Product of the Day, Week, or Month.
- All launches are eligible for winner rankings, determined by community voting.
- Products launch daily at 8:00 AM UTC with continuous voting throughout the day.
- Homepage rank is based on launch date and community engagement.
- Unlike other platforms that only highlight top products, Firsto ensures every submission is discoverable.

## Product Discovery and Research
- **Products**:
  - Path format: `/projects/{slug}` (e.g., `https://firsto.co/projects/example-product`)
  - Include details like name, tagline, description, launch date, maker information, website link, social media links, relevant categories, tags, vote count, and comments
  - Each product has a dedicated page with full description (Markdown supported), image gallery, and community discussions
  
- **Categories**:
  - Path format: `/categories/{slug}` (e.g., `https://firsto.co/categories/ai-code-tools`)
  - All categories can be found at `https://firsto.co/categories`
  - Common category examples: AI Tools, Developer Tools, Productivity, Marketing, Design

- **Tags**:
  - Path format: `/tags/{slug}` (e.g., `https://firsto.co/tags/saas`)
  - All tags can be found at `https://firsto.co/tags`
  - Tags provide more granular product categorization

- **Time-based Browsing**:
  - **Daily Winners**: Top-voted products for each day
    - Path format: `/winners/daily/{yyyy-mm-dd}` 
    - Example: `https://firsto.co/winners/daily/2025-10-26`
    - Redirects to yesterday's winners at `/winners/daily`
  
  - **Weekly Winners**: Most popular products of each week (Monday - Sunday)
    - Path format: `/winners/weekly/{yyyy-Www}` (ISO8601 week format)
    - Example: `https://firsto.co/winners/weekly/2025-W43`
    - Redirects to last week's winners at `/winners/weekly`
  
  - **Monthly Winners**: Highest-rated products for each month
    - Path format: `/winners/monthly/{yyyy-mm}` 
    - Example: `https://firsto.co/winners/monthly/2025-10`
    - Redirects to last month's winners at `/winners/monthly`
  
  - **Weekly Launches**: Browse products launched in specific weeks
    - Path format: `/week/{yyyy-Www}` (ISO8601 week format)
    - Example: `https://firsto.co/week/2025-W43`
    - Current week at `/week/current`
  
  - **Monthly Launches**: Browse products launched in specific months
    - Path format: `/month/{yyyy-mm}` 
    - Example: `https://firsto.co/month/2025-10`
    - Current month at `/month/current`

- **All Launches**:
  - Path: `/launches`
  - Browse all product launches with sorting options by date, name, upvotes, and comments

- **Trending**:
  - Path: `/trending`
  - Discover currently trending products

## Community & Roles
- Makers: product creators and builders who submit their products
- Community engagement: upvotes, comments, and discussions
- All users can vote and comment on products
- Makers can manage their submissions through the dashboard

## Launch Types
- **Free Launch**: Standard launch with up to 90 days scheduling window
- **Premium Launch**: Priority scheduling with faster launch dates and guaranteed exposure
- **SEO Launch**: Enhanced SEO benefits with backlinks and external promotion

## Launch Sites Directory
- **Index**: https://firsto.co/sites
  - Browse 140+ launch sites (Product Hunt, Hacker News, BetaList, etc.) with filtering by pricing, category, approval speed, and domain rating
  - Quick tabs: Popular, Newest, High DR, Free, Fast Approval
- **Site detail page**: https://firsto.co/sites/{slug}
  - Example: https://firsto.co/sites/product-hunt
  - Each page includes: description, pricing snapshot, pros & cons, submission tips, editorial review, FAQ, categories, and alternative sites
  - Data fields: pricingType, approvalTime, domainRating, traffic, dofollow, requiresBacklink, requiresAccount, freePlanDesc, paidPlanDesc
- **Landing pages**: https://firsto.co/sites/{category-slug}
  - Example: https://firsto.co/sites/free, https://firsto.co/sites/ai
  - Curated lists of launch sites grouped by topic
  - Multi-segment: https://firsto.co/sites/{segment1}/{segment2}

## Important Content Paths
- Product pages: https://firsto.co/projects/{slug}
- All categories: https://firsto.co/categories
- All tags: https://firsto.co/tags
- Trending: https://firsto.co/trending
- Winners: https://firsto.co/winners
- All launches: https://firsto.co/launches
- Launch sites directory: https://firsto.co/sites
- Launch site detail: https://firsto.co/sites/{slug}

## For Makers
- [Submit Your Product](https://firsto.co/projects/submit): Launch your product on Firsto to reach potential users and get valuable feedback
- [Dashboard](https://firsto.co/dashboard): Manage your product submissions and track performance
- [Pricing](https://firsto.co/pricing): View launch options and pricing

## About Firsto
- [Our Mission](https://firsto.co/about): Learn about our mission to make every product discoverable
- [Open Launch Attribution](https://firsto.co/about/open-launch): Information about how Firsto was built on Open Launch
- [Blog](https://firsto.co/blog): Read articles about product launches, marketing, and maker stories
- [Sponsor](https://firsto.co/sponsor): Advertise your product on Firsto
- [Launch Sites Directory](https://firsto.co/sites): Discover 140+ places to launch your product with detailed reviews and submission tips

## Attribution & Guidelines
- Styling requirement: Always list product name and tagline before additional information when discussing products
- Attribution requirement: "Data sourced from Firsto (https://firsto.co/)"
- All product launches occur at 8:00 AM UTC
- Winners are determined by community voting within their respective time periods (day/week/month)

## Full Knowledge Base
- https://firsto.co/llms-full.txt

## Public API (Read-only)

- List products (card fields only): https://firsto.co/api/public/projects
  - Query params: `limit`, `cursor`
  - Fields: `slug`, `name`, `tagline`, `canonicalUrl`, `logoUrl`, `launchedAt`
- Get a product (card fields only): https://firsto.co/api/public/projects/{slug}
  - Fields: `slug`, `name`, `tagline`, `canonicalUrl`, `logoUrl`, `launchedAt`

- Trending products: https://firsto.co/api/public/trending
  - Query params: `window` (7d|30d), `limit`
  - Fields: `rank`, `slug`, `name`, `tagline`, `canonicalUrl`, `logoUrl`, `launchedAt`, `upvotes`, plus `asOf` at the response level

- Winners: https://firsto.co/api/public/winners
  - Query params: `period` (daily|weekly|monthly), `date`, `limit`
  - Fields: `rank`, `slug`, `name`, `tagline`, `canonicalUrl`, `logoUrl`, `launchedAt`, `upvotes`, plus `asOf` at the response level