Skip to main content

​
Quick Start Guide

Get up and running with AiVault in just a few minutes. This guide will walk you through browsing tools, creating an account, and submitting your first AI tool.

​
Browse AI Tools

1

Visit the Directory

Navigate to the Tools Directory to explore all available AI tools. You’ll see a comprehensive list of curated tools with filtering options.The directory includes tools from industry leaders like OpenAI, Anthropic, Google, GitHub, Adobe, Notion, Canva, and Figma.
2

Search and Filter

Use the powerful search bar to find specific tools:
// Search is handled client-side with real-time updates
const handleSearch = (e: React.FormEvent) => {
  e.preventDefault();
  if (search.trim()) {
    router.push(`/tools?search=${encodeURIComponent(search)}`);
  }
};
Filter by:
  • Category: Writing, Image, Coding, Video, Audio, and more
  • Pricing: Free, Freemium, or Paid
  • Sort: Newest first or by upvotes
All filters work in real-time thanks to Convex’s reactive backend. No page refresh needed!
3

View Tool Details

Click on any tool to see detailed information including:
  • Description and long-form overview
  • Features and use cases
  • Pros and cons
  • Pricing details
  • Supported platforms (Web, iOS, Android, Desktop, API, Chrome Extension)
  • Social links (Twitter, GitHub, Discord)

​
Create an Account

1

Sign Up

Click the Sign Up button in the navigation bar. AiVault uses Clerk for secure authentication.You can sign up using:
  • Email and password
  • Google OAuth
  • GitHub OAuth
  • Other supported providers
2

Complete Your Profile

Once signed in, you’ll have access to personalized features:
  • Bookmark your favorite tools
  • Submit new tools for review
  • View your submission history
  • Leave reviews and ratings
AiVault uses JWT-based session management with Clerk, ensuring your account is secure with industry-standard authentication.

​
Submit Your First Tool

1

Navigate to Submit Page

Click the Submit a Tool button from the homepage or navigation menu.
<Button className="rounded-md" size="lg" variant="secondary" asChild>
  <Link href="/submit">
    <SparklesIcon className="size-4 mr-2" />
    Submit a Tool
  </Link>
</Button>
2

Fill Out the Submission Form

Provide details about the AI tool:Required Fields:
  • Tool name
  • Short description
  • Category (Writing, Image, Coding, etc.)
  • Website URL
  • Pricing type (Free, Freemium, Paid)
  • Tags (array of keywords)
Optional Fields:
  • Long description
  • Logo URL
  • Pricing details
  • Features list
  • Use cases
  • Pros and cons
  • Supported platforms
  • Social media links (Twitter, GitHub, Discord)
3

Submit for Review

Click submit and your tool will be added to the pending queue:
export const submitTool = mutation({
  args: {
    name: v.string(),
    description: v.string(),
    category: v.string(),
    tags: v.array(v.string()),
    websiteUrl: v.string(),
    pricing: v.string(),
    // ... other fields
  },
  handler: async (ctx: MutationCtx, args: any) => {
    const identity = await getIdentity(ctx);
    const slug = args.name.toLowerCase()
      .replace(/[^a-z0-9]+/g, "-")
      .replace(/(^-|-$)+/g, "");
    
    const toolId = await ctx.db.insert("tools", {
      ...args,
      slug,
      upvotes: 0,
      submittedBy: identity.subject,
      approved: false, // Requires admin approval
      createdAt: Date.now(),
      isNew: true,
    });
    
    return { toolId, slug };
  },
});
All submissions require admin approval before appearing in the public directory. This ensures quality and prevents spam.
4

Track Your Submission

View your submitted tools in your profile. You’ll be notified once your submission is reviewed.Admins can:
  • Approve your submission (it becomes publicly visible)
  • Reject it with feedback (you can resubmit with improvements)

​
Next Steps

Explore Features

Learn about bookmarks, admin dashboard, and advanced filtering

API Reference

Integrate with Convex queries and mutations
Need help? Check out the full documentation or reach out to the AiVault community on GitHub.

Build docs developers (and LLMs) love

Get started for freeTalk to us