Lib UI (Alpha)

⚠️ Note: This project is currently in active development. APIs and features may change.

Lib UI is a revolutionary full-stack component library that combines the power of frontend components with backend functionality for Next.js applications. Build production-ready applications faster than ever before.

Why Lib UI?

In today's JavaScript ecosystem, we have countless libraries for frontend components and backend tools. Lib UI bridges this gap by offering:

• Full-stack Components: Get both UI and logic in a single package
• Ready-to-use Solutions: Implement complex features like authentication and payments with one command
• Customizable Building Blocks: Maintain full control while leveraging pre-built functionality
• Developer Experience: Focus on building your product, not wrestling with documentation

Installation

npm install lib-ui-cli -D
# or
yarn add lib-ui-cli -D
# or
pnpm add lib-ui-cli -D

Usage

Adding Authentication

npx lib-ui add auth

# This creates:
# /components/auth/
#   ├── sign-in-form.tsx
#   ├── sign-up-form.tsx
#   ├── auth-provider.tsx
#   └── ...
# 
# /app/api/auth/
#   ├── [...nextauth]/route.ts
#   └── ...
#
# /lib/auth/
#   ├── config.ts
#   └── utils.ts

Then use it in your code:

import { SignInForm } from '@/components/auth/sign-in-form'

export default function LoginPage() {
  return <SignInForm />
}

Adding Payments

npx lib-ui add payments

# This creates:
# /components/payments/
#   ├── payment-form.tsx
#   ├── pricing-table.tsx
#   └── ...
#
# /app/api/payments/
#   ├── webhook/route.ts
#   ├── create-checkout/route.ts
#   └── ...
#
# /lib/payments/
#   ├── stripe.ts
#   └── utils.ts

Planned Features

Each feature can be added individually through our CLI:

• 🔒 npx lib-ui add auth - Authentication with Auth.js
• 💳 npx lib-ui add payments - Stripe payments integration
• 📝 npx lib-ui add forms - Form components with validation
• 📊 npx lib-ui add dashboard - Admin dashboard components
• 📧 npx lib-ui add email - Email templates and sending logic
• 🔍 npx lib-ui add search - Search functionality with various backends

Benefits

• 🎨 Own Your UI - All components are added to your codebase
• ⚡ Full Control - Modify any part of the code to suit your needs
• 🔧 No Lock-in - Once installed, components don't depend on Lib UI
• 📦 Type Safe - Full TypeScript support
• 🚀 Best Practices - Following latest Next.js patterns

Development Roadmap

1. Q1 2025
   • CLI development
   • Auth component generation
   • Basic documentation
2. Q2 2025
   • Payment components
   • Email integration
   • Interactive component customization
3. Q3 2025
   • Additional modules
   • Beta release

Contributing

We're building this in public and welcome contributions! While we're still setting up our contribution guidelines, feel free to:

• Star the repo to show your interest
• Open issues for feature requests or bugs
• Submit PRs for improvements
• Join our discussions

Stay Updated

• Follow us on Twitter @LibUI
• Join our Discord community (coming soon)
• Star this repository for updates

License

MIT License - see the LICENSE file for details.