⭐ Star this repo to stay up to date with future releases ⭐

The shadcn for backend. Build production-ready AI applications with Convex components.

Neutral Components is a collection of Convex components that handle the hard parts of building AI-powered applications. Each component is independent, well-tested, and designed to work seamlessly together.

Think shadcn/ui, but for your backend infrastructure.

Component	npm	Description	Status
neutral-cost		Track AI and tool costs, manage credits, bill customers	✅ Released
neutral-tools	neutral-tools	Write tools once, run in any AI framework (AI SDK, Pipecat, etc.)	Coming Soon
neutral-files	neutral-files	Unified S3-compatible API for all storage providers	Coming Soon
neutral-agent	neutral-agent	Production patterns for internal and user-facing agents	Coming Soon
neutral-vfs	neutral-vfs	Virtual file system for coding agents and sandboxes	Coming Soon

Convex components provide true isolation - each component runs in its own namespace with its own tables and functions. This means:

• No conflicts - Components can't accidentally interfere with your app or each other
• Easy upgrades - Update components independently without migrations
• Type safety - Full TypeScript support with generated types
• Real-time by default - All queries are live and reactive

1. Set up a Convex project if you haven't already:

   npm create convex

2. Install any component:

   npm install neutral-cost

3. Add it to your convex/convex.config.ts:

   import { defineApp } from "convex/server";
   import costComponent from "neutral-cost/convex.config";
   
   const app = defineApp();
   app.use(costComponent);
   
   export default app;

4. Start using it in your functions.

• Composable - Use one component or all of them
• Escape hatches - Extend functionality with neutral-cli when needed
• Production-ready - Built for real workloads, not demos
• Open source - FSL-1.1-ALv2 licensed (Apache 2.0 after 2 years)

• Convex - The backend platform these components run on
• Convex Components Docs - Learn more about the component system

All components are licensed under FSL-1.1-ALv2 - Functional Source License with Apache 2.0 future license.