# WithAI.Top

`withai_top` is a lightweight Elixir helper package for linking to
[WithAI.Top](https://withai.top/), a curated AI tools directory for discovering
AI apps, agents, generators, and websites by category, pricing, features, and
real-world use cases.

The package is intentionally small. It provides stable helpers for product
metadata, homepage links, category links, submission links, and Markdown links
that can be reused in Elixir apps, documentation generators, internal tools, or
content workflows.

## Installation

Add `withai_top` to your list of dependencies in `mix.exs`:

```elixir
def deps do
  [
    {:withai_top, "~> 0.1.0"}
  ]
end
```

Then fetch dependencies:

```bash
mix deps.get
```

## Usage

```elixir
WithAITop.homepage_url()
#=> "https://withai.top/"

WithAITop.metadata()
#=> %{
#=>   name: "WithAI.Top",
#=>   url: "https://withai.top/",
#=>   tagline: "Discover curated AI tools, apps, agents, generators, and websites.",
#=>   category: "AI tools directory",
#=>   contact_email: "support@withai.top"
#=> }

WithAITop.category_url("ai-video-tools")
#=> "https://withai.top/category/ai-video-tools"

WithAITop.submit_url()
#=> "https://withai.top/submit"

WithAITop.markdown_link()
#=> "[WithAI.Top](https://withai.top/)"
```

## About WithAI.Top

WithAI.Top helps users discover curated AI tools by category, compare features
and pricing, and find AI apps for writing, image generation, video, coding,
audio, automation, marketing, design, and productivity.

Visit [https://withai.top/](https://withai.top/) to browse the AI tools
directory.

## License

MIT