import { CheckCircleSolid, BuildingStorefront, BuildingsSolid, ComputerDesktop, FlyingBox } from "@medusajs/icons"
import { config } from "@/config"
import { Table } from "docs-ui"

export const metadata = {
  title: `${pageNumber} Introduction`,
}

# {metadata.title}

Medusa is a digital commerce platform with a built-in framework for customization.

Medusa ships with three main tools:

1. A suite of [commerce modules](!resources!/commerce-modules) with core commerce functionalities, such as tracking inventory, calculating cart totals, accepting payments, managing orders, and much more.
2. A framework for building custom functionalities specific to your business, product, or industry. This includes tools for introducing custom API endpoints, business logic, and data models; building workflows and automations; and integrating with third-party services.
3. A customizable admin dashboard for merchants to configure and operate their store.

When you install Medusa, you get a fully fledged commerce platform with all the features you need to get off the ground. However, unlike other platforms, Medusa is built with customization in mind. You don't need to build hacky workarounds that are difficult to maintain and scale. Your efforts go into building features that brings your business's vision to life.

---

## Who should use Medusa

Medusa is for businesses and teams looking for a digital commerce platform with the tools to implement unique requirements that other platforms aren't built to support.

Businesses of all sizes can use Medusa, from small start ups to large enterprises. Also, technical teams of all sizes can build with Medusa; all it takes is a developer to manage and deploy Medusa projects.

Below are some stories from companies that use Medusa:

<CardList items={[
  {
    title: "Use Case: D2C",
    text: "How Matt Sleeps built a unique D2C experience with Medusa",
    href: "https://medusajs.com/blog/matt-sleeps/",
    icon: FlyingBox,
  },
  {
    title: "Use Case: OMS",
    text: "How Makro Pro Built an OMS with Medusa",
    href: "https://medusajs.com/blog/makro-pro/",
    icon: CheckCircleSolid,
  },
  {
    title: "Use Case: Marketplace",
    text: "How Foraged built a custom marketplace with Medusa",
    href: "https://medusajs.com/blog/foraged/",
    icon: BuildingStorefront,
  },
  {
    title: "Use Case: POS",
    text: "How Tekla built a global webshop and a POS system with Medusa",
    href: "https://medusajs.com/blog/tekla-pos/",
    icon: ComputerDesktop,
  },
  {
    title: "Use Case: B2B",
    text: "How Visionary built B2B commerce with Medusa",
    href: "https://medusajs.com/blog/visionary/",
    icon: BuildingsSolid,
  },
  {
    title: "Use Case: Platform",
    text: "How Catalog built a B2B platform for SMBs with Medusa",
    href: "https://medusajs.com/blog/catalog/",
    icon: BuildingsSolid,
  }
]} itemsPerRow={2} />

---

## Who is this documentation for

This documentation introduces you to Medusa's concepts and how they help you build your business use case. The documentation is structured to gradually introduce Medusa's concepts, with easy-to-follow examples along the way.

By following this documentation, you'll be able to create custom commerce experiences that would otherwise take large engineering teams months to build.

### How to use the documentation

This documentation is split into the following sections:

<Table>
  <Table.Header>
    <Table.Row>
      <Table.HeaderCell>Section</Table.HeaderCell>
      <Table.HeaderCell className="w-2/3">Description</Table.HeaderCell>
    </Table.Row>
  </Table.Header>
  <Table.Body>
    <Table.Row>
      <Table.Cell>
        [Main Documentation](./page.mdx)
      </Table.Cell>
      <Table.Cell>
        The documentation you're currently reading. It's recommended to follow the chapters in this documentation to understand the core concepts of Medusa and how to use them before jumping into the other sections.
      </Table.Cell>
    </Table.Row>
    <Table.Row>
      <Table.Cell>
        Product
      </Table.Cell>
      <Table.Cell>
        Documentation for the [Commerce](!resources!/commerce-modules) and [Architectural](!resources!/architectural-modules) Modules. You can browse those to learn more about Medusa's commerce and architectural features, and find guides specific to each of these modules.
      </Table.Cell>
    </Table.Row>
    <Table.Row>
      <Table.Cell>
        Build
      </Table.Cell>
      <Table.Cell>
        [Recipes](!resources!/recipes), [How-To & Tutorials](!resources!/how-to-tutorials), [Integrations](!resources!/integrations), and [Storefront Development](!resources!/storefront-development) guides. You can follow these guides after you've learned Medusa's core concepts.
      </Table.Cell>
    </Table.Row>
    <Table.Row>
      <Table.Cell>
        [Tools](!resources!/tools)
      </Table.Cell>
      <Table.Cell>
        Guides on how to setup and use Medusa's CLI tools, [JS SDK](!resources!/js-sdk), [Next.js Starter](!resources!/nextjs-starter), and [Medusa UI](!ui!)
      </Table.Cell>
    </Table.Row>
    <Table.Row>
      <Table.Cell>
        API Routes References
      </Table.Cell>
      <Table.Cell>
        References of the [Store](!api!/store) and [Admin](!api!/admin) API routes in Medusa. They also include instructions related to authentication, parameter types in requests, and more.
      </Table.Cell>
    </Table.Row>
    <Table.Row>
      <Table.Cell>
        [References](!resources!/references-overview)
      </Table.Cell>
      <Table.Cell>
        Useful during your development with Medusa to learn about different APIs and how to use them. Its references include the [Events Reference](!resources!/events-reference), [Core Workflows Reference](!resources!/medusa-workflows-reference), and more.
      </Table.Cell>
    </Table.Row>
    <Table.Row>
      <Table.Cell>
        [User Guide](!user-guide!)
      </Table.Cell>
      <Table.Cell>
        Guides that introduce merchants and store managers to the Medusa Admin dashboard and helps them understand how to use the dashboard to manage their store.
      </Table.Cell>
    </Table.Row>
  </Table.Body>
</Table>

To get started, check out the [Installation chapter](./installation/page.mdx).

### Using with LLM Editors

This documentation provides an [llms-full.txt](https://docs.medusajs.com/llms-full.txt) file to support LLM editors. To access the documentation directly from your editor and benefit from code generation, add [https://docs.medusajs.com/llms-full.txt](https://docs.medusajs.com/llms-full.txt) as a custom documentation source in your LLM editor, such as [Cursor](https://docs.cursor.com/context/@-symbols/@-docs).

---

## Useful Links

- Need Help? Refer to our [GitHub repository](https://github.com/medusajs/medusa) for [issues](https://github.com/medusajs/medusa/issues) and [discussions](https://github.com/medusajs/medusa/discussions).
- [Join the community on Discord](https://discord.gg/medusajs).
- Have questions or need more support? Contact our [sales team](https://medusajs.com/contact/).
- Facing issues in your development? Refer to our [troubleshooting guides](!resources!/troubleshooting).
