> ## Documentation Index
> Fetch the complete documentation index at: https://docs.urban-things.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Urban Things Documentation

> Multi-tenant e-commerce platform API documentation

## Welcome to Urban Things

Urban Things is a powerful multi-tenant e-commerce platform that enables multiple organizations to manage their online stores with complete data isolation, team collaboration, and comprehensive API access.

<Card title="Get Started in Minutes" icon="rocket" href="/essentials/getting-started" horizontal>
  Follow our quick start guide to create your first tenant and start building.
</Card>

## Core Features

<CardGroup cols={2}>
  <Card title="Multi-Tenant Architecture" icon="building" href="/essentials/multi-tenancy">
    Users can belong to multiple organizations with different roles and permissions.
  </Card>

  <Card title="Team Management" icon="users" href="/api-reference/team-members/list">
    Add, update, and manage team members with role-based access control.
  </Card>

  <Card title="Product Catalog" icon="box" href="/api-reference/products/list">
    Complete product and category management with automatic tenant scoping.
  </Card>

  <Card title="Webhook Integration" icon="webhook" href="/api-reference/webhooks/list">
    Real-time event notifications for seamless third-party integrations.
  </Card>
</CardGroup>

## Quick Links

<Columns cols={2}>
  <Card title="API Reference" icon="terminal" href="/api-reference/introduction">
    Explore all available API endpoints with examples and responses.
  </Card>

  <Card title="Architecture Guide" icon="diagram-project" href="/essentials/architecture">
    Understand the system architecture and database design.
  </Card>

  <Card title="Authentication" icon="lock" href="/api-reference/endpoint/login">
    Learn how to authenticate and secure your API requests.
  </Card>

  <Card title="Multi-Tenancy" icon="shield" href="/essentials/multi-tenancy">
    Deep dive into how multi-tenancy works and best practices.
  </Card>
</Columns>

## API Capabilities

Everything you need to build a complete e-commerce solution:

<CardGroup cols={3}>
  <Card title="Authentication" icon="key">
    Sanctum token-based auth with Firebase integration
  </Card>

  <Card title="Tenant Management" icon="building">
    Create and manage multiple organizations
  </Card>

  <Card title="Team Members" icon="user-group">
    ADMIN and MEMBER roles per tenant
  </Card>

  <Card title="Products" icon="shopping-bag">
    Full CRUD operations with images and variations
  </Card>

  <Card title="Categories" icon="folder-tree">
    Organize products with hierarchical categories
  </Card>

  <Card title="Orders" icon="cart-shopping">
    Complete order processing and management
  </Card>

  <Card title="Webhooks" icon="bell">
    Event-driven integrations with delivery tracking
  </Card>

  <Card title="Ratings" icon="star">
    Product reviews and ratings system
  </Card>

  <Card title="Addresses" icon="location-dot">
    User address management
  </Card>
</CardGroup>

## Tech Stack

<Tabs>
  <Tab title="Backend">
    * Laravel 11.9
    * PHP 8.2+
    * MySQL (Production)
    * SQLite (Testing)
  </Tab>

  <Tab title="Authentication">
    * Laravel Sanctum
    * Bearer Token Auth
    * Firebase Integration
  </Tab>

  <Tab title="Features">
    * Multi-tenant architecture
    * Role-based access control
    * Event-driven webhooks
    * Automatic tenant scoping
  </Tab>
</Tabs>

## Need Help?

<CardGroup cols={2}>
  <Card title="Contact Support" icon="envelope" href="mailto:info@faisalkc.com">
    Get help from our support team
  </Card>

  <Card title="View on GitHub" icon="github" href="https://github.com">
    Contribute or report issues
  </Card>
</CardGroup>