# Caraka Full Context

> This is the comprehensive context and documentation file for Caraka — a premium design asset marketplace. Caraka offers UI kits, icon packs, Figma templates, and design resources for designers and product teams.

## 1. Platform Overview & The Core Offer
Caraka is a **premium design asset marketplace** where professionals buy production-ready design resources. We help designers and agencies build products faster with premium design assets.

### What We Sell:
- **Premium Icon Packs**: Vector-perfect line, solid, duotone, and 3D icons in Figma, SVG, and PNG formats.
- **UI Kits & Design Templates**: Production-ready website, dashboard, and mobile layouts for SaaS, tech, finance, and e-commerce.
- **Design Systems & Components**: Reusable Figma components and scalable design resources for agencies and product teams.

### Who Uses Caraka:
- **UI/UX Designers** — building mobile apps, websites, and dashboards
- **Product Teams** — SaaS startups and tech companies building digital products
- **Design Agencies** — looking for scalable design resources for client work
- **Freelancers** — independent designers serving client projects

---

## 2. Product Catalog & Classification
Products are categorized and filtered on the frontend across several taxonomies:
- **Product Types**: UI Kits, Templates, Icon Packs, 3D Assets, etc.
- **Platforms**: Figma, Sketch, Adobe XD, HTML/CSS, React, Tailwind CSS, Framer, Webflow, etc.
- **Industries**: SaaS, Finance, E-commerce, Healthcare, Education, Tech, etc.
- **Icon Styles**: Line, Solid, Duotone, Flat, 3D, Outline, etc.
- **File Formats**: .fig, .svg, .png, .zip, .html, .sketch, .xd, etc.

Users can browse, filter, and sort products by relevance, popularity, latest releases, and pricing (free vs. paid).

---

## 3. Licensing Options
Caraka offers structured licensing options to suit various needs:
- **Personal License**: Permitted for non-commercial, personal, and educational projects.
- **Commercial License**: Permitted for commercial projects, client work, business websites, and professional design use (for single users/teams).
- **Extended License**: Permitted for redistribution, integration into SaaS templates, theme builders, or large-scale enterprise deployment.

---

## 4. Search & Discovery
Caraka provides a powerful, instant search engine on its homepage:
- **Simple search**: Instant suggestions within the search modal.
- **Fuzzy & Typo-Tolerant Search**: Auto-activated when users press Enter to submit search queries, ensuring users find matches even with spelling mistakes.
- **History Tracking**: Keeps track of recent user searches locally via cookies for a personalized discovery experience.

---

## 5. Asset Download & Security
Paid assets are secured using a single-use download token system:
- **Download Grants**: When a purchase is completed, a SHA-256 secure token is generated.
- **Single Use**: Link token is designed for single-use by default for maximum security.
- **Expiration**: Tokens are time-limited (TTL of 10080 minutes / 7 days) and automatically expire or get revoked if the download count limit is exceeded.

---

## 6. Editorial Blog System
The Caraka Blog serves articles and tutorials about design systems, UI best practices, and productivity:
- **Categories**: Dev, Design, Case Studies, Updates, etc.
- **Topics**: UI design best practices, Figma workflows, design system architecture, product design tips.
- **Engagement**: Users can daily clap for articles (up to 20 claps per day per IP address) and track views.
- **Newsletter**: Readers can subscribe to stay updated with design tips and new asset launches.
- **Block-Based Content**: Articles are rendered using a structured block system (headings, paragraphs, lists, quotes, code highlights, and galleries) styled natively with Tailwind CSS v4.