Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

60 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ui69

Unstyled, accessible UI components for React Native, inspired by shadcn/ui.

What is ui69?

ui69 is a collection of reusable, customizable UI components for React Native. Unlike traditional component libraries, ui69 doesn't publish the components as a package. Instead, it provides a CLI that adds the components directly to your project. This gives you complete control over the components, including the ability to customize them to fit your needs.

Features

  • 🚀 Copy and paste - Components are added directly to your project
  • 💪 Customizable - Modify components to fit your specific needs
  • 🔍 Accessible - Built with accessibility in mind
  • 📝 TypeScript - Fully typed components
  • 📱 React Native friendly - Works with both Expo and React Native CLI

Installation

# Install using npx
npx ui69 add <component>

# Or install the CLI globally
npm install -g ui69
ui69 add <component>

Usage

# Add components to your project
npx ui69 add button

# Add multiple components interactively
npx ui69 add

# List all available components
npx ui69 list

Available Components

  • Button - A pressable button component with multiple variants and sizes
  • Skeleton - Loading placeholder component with shimmer and wave animations
  • Avatar - User profile image with fallback, status indicators, and grouping support
  • Badge - Small status indicator with multiple variants and dot style option
  • Card - Container component with header, content and footer sections
  • Seperator - Simple divider component for separating content
  • Accordion - Collapsible content sections with customizable styling and animations
  • Input - Text input component with multiple variants, validation, and icon support
  • InputOTP - One-time password input component with support for different input types
  • Toast - Notification component with animations, gestures, and multiple variants
  • Select - Dropdown select component with smooth animations and smart positioning
  • More components coming soon!

Select Component Example

import React, { useState } from 'react';
import { View } from 'react-native';
import { SafeAreaProvider } from 'react-native-safe-area-context';
import {
    Select,
    SelectContent,
    SelectGroup,
    SelectItem,
    SelectLabel,
    SelectTrigger,
    SelectValue,
} from './components/ui/select';

export default function App() {
    const [selectedValue, setSelectedValue] = useState('');

    return (
        <SafeAreaProvider>
            <View style={{ padding: 20 }}>
                {/* Basic Select */}
                <Select value={selectedValue} onValueChange={setSelectedValue}>
                    <SelectTrigger style={{ width: 200 }}>
                        <SelectValue placeholder="Select a fruit" />
                    </SelectTrigger>
                    <SelectContent>
                        <SelectGroup>
                            <SelectLabel>Fruits</SelectLabel>
                            <SelectItem value="apple">Apple</SelectItem>
                            <SelectItem value="banana">Banana</SelectItem>
                            <SelectItem value="orange">Orange</SelectItem>
                        </SelectGroup>
                    </SelectContent>
                </Select>

                {/* Uncontrolled Select with Default Value */}
                <Select defaultValue="medium">
                    <SelectTrigger style={{ width: 200, marginTop: 20 }}>
                        <SelectValue placeholder="Select size" />
                    </SelectTrigger>
                    <SelectContent>
                        <SelectItem value="small">Small</SelectItem>
                        <SelectItem value="medium">Medium</SelectItem>
                        <SelectItem value="large">Large</SelectItem>
                    </SelectContent>
                </Select>
            </View>
        </SafeAreaProvider>
    );
}

Select Features

  • Smart positioning: Automatically positions dropdown to avoid screen edges
  • Smooth animations: Fade, scale, and slide animations for opening/closing
  • Controlled/Uncontrolled: Supports both controlled and uncontrolled usage patterns
  • Groups and labels: Organize options with visual groupings
  • Disabled states: Component and individual item disable support
  • Touch optimized: Designed for mobile touch interactions
  • Accessible: Proper accessibility roles and states
  • Customizable styling: Easy to customize appearance
  • TypeScript: Fully typed for better developer experience

Select Dependencies

The Select component requires:

npm install react-native-safe-area-context react-native-svg

For Expo projects:

npx expo install react-native-safe-area-context react-native-svg

For React Native CLI projects, you'll also need to complete the platform-specific installation for react-native-svg. See the react-native-svg documentation for detailed setup instructions.

Toast Component Example

import React from 'react';
import { View } from 'react-native';
import { SafeAreaProvider } from 'react-native-safe-area-context';
import { GestureHandlerRootView } from 'react-native-gesture-handler';
import { ToastProvider, useToastController } from './components/ui/toast';
import { Button } from './components/ui/button';

// Wrap your app with required providers
export default function App() {
  return (
    <SafeAreaProvider>
      <GestureHandlerRootView style={{ flex: 1 }}>
        <ToastProvider position="top-center" maxToasts={3}>
          <ToastExample />
        </ToastProvider>
      </GestureHandlerRootView>
    </SafeAreaProvider>
  );
}

// Usage in your components
function ToastExample() {
  const { success, error, warning, info } = useToastController();

  return (
    <View style={{ padding: 20, gap: 10 }}>
      <Button onPress={() => success({ 
        title: "Success!", 
        description: "Your action was completed" 
      })}>
        Show Success Toast
      </Button>

      <Button onPress={() => error({ 
        title: "Error occurred", 
        description: "Something went wrong" 
      })}>
        Show Error Toast
      </Button>
    </View>
  );
}

Toast Features

  • 5 variants: default, success, error, warning, info
  • Gesture support: Swipe to dismiss
  • Positioning: 6 different positions (top/bottom + left/center/right)
  • Auto-dismiss: Configurable duration or persistent toasts
  • Action buttons: Interactive buttons within toasts
  • Custom icons: Use your own icons or default variant icons
  • Stacking: Multiple toasts with smooth animations
  • TypeScript: Fully typed for better developer experience

Toast Dependencies

The Toast component requires these additional packages:

npm install react-native-gesture-handler react-native-safe-area-context

For Expo projects:

npx expo install react-native-gesture-handler react-native-safe-area-context

Skeleton Component Example

import { View } from 'react-native';
import { Skeleton } from './components/ui/skeleton';

export default function App() {
  return (
    <View style={{ padding: 16, gap: 8 }}>
      {/* Default shimmer animation */}
      <Skeleton width="100%" height={20} />
      
      {/* Wave animation */}
      <Skeleton 
        width="80%" 
        height={20} 
        animationType="wave" 
      />
      
      {/* Custom styling */}
      <Skeleton 
        width={60} 
        height={60} 
        borderRadius={30}
        backgroundColor="#c0c0c0"
        highlightColor="rgba(255, 255, 255, 0.6)"
      />
    </View>
  );
}

Accordion Component Example

import {
  Accordion,
  AccordionContent,
  AccordionItem,
  AccordionTrigger,
} from "@/components/ui/accordion"

export function AccordionDemo() {
  return (
    <Accordion>
      <AccordionItem value="item-1">
        <AccordionTrigger>Is it accessible?</AccordionTrigger>
        <AccordionContent>
          Yes. It adheres to the WAI-ARIA design pattern.
        </AccordionContent>
      </AccordionItem>
      
      <AccordionItem value="item-2">
        <AccordionTrigger>Is it styled?</AccordionTrigger>
        <AccordionContent>
          Yes. It comes with default styles that matches the other
          components' aesthetic.
        </AccordionContent>
      </AccordionItem>
    </Accordion>
  )
}

License

MIT

Acknowledgments

This project is inspired by shadcn/ui, which offers a similar approach for web applications.

About

Unstyled, accessible UI components for React Native - inspired by shadcn/ui. Copy, paste, and customize components directly in your project.

Topics

Resources

Stars

6 stars

Watchers

1 watching

Forks

Releases

Packages

Used by

Contributors

Languages