Monocharts README

The project's README from github.com/Subhan-code/Monocharts. As one markdown file: README.md.

@subhanhq/amicro

A curated collection of premium React micro-interactions, transition components, and card layouts powered by Motion.

npm version License GitHub Stars Sponsor


╭──────────────────────── Amicro CLI ────────────────────────╮
│ npx @subhanhq/amicro@latest init     initialize project    │
│ npx @subhanhq/amicro@latest add      add UI components     │
╰────────────────────────────────────────────────────────────╯

⚡️ Quick Start

Installation

npm install @subhanhq/amicro
# or
yarn add @subhanhq/amicro
# or
pnpm add @subhanhq/amicro

CLI Command Usage

# 1. Initialize configuration in your React / Next.js / Vite project
npx @subhanhq/amicro@latest init

# 2. Add individual components directly to your codebase
npx @subhanhq/amicro@latest add download-button

# 3. Add card interaction components
npx @subhanhq/amicro@latest add card-arc-5

🎨 shadcn/ui Registry Integration

You can add Amicro motion primitives, custom hooks, and spring presets directly to your project using the shadcn CLI!

1. Direct URL Installation

You can install any component directly by referencing its public raw URL:

npx shadcn add https://raw.githubusercontent.com/Subhan-code/Amicro--Micro-transitions-/main/registry/ui/fade-in.json

Add the @amicro namespace to the registries field in your project's components.json:

{
  "registries": {
    "@amicro": "https://raw.githubusercontent.com/Subhan-code/Amicro--Micro-transitions-/main/registry/{name}.json"
  }
}

Now, you can install any component, hook, or utility directly by name:

# Install entrance transition components (placed under components/amicro/)
npx shadcn add @amicro/fade-in
npx shadcn add @amicro/fade-up
npx shadcn add @amicro/zoom-in

# Install hover & text components
npx shadcn add @amicro/tilt-card
npx shadcn add @amicro/magnetic-button
npx shadcn add @amicro/text-reveal

# Install hooks & utilities
npx shadcn add @amicro/use-scroll-progress
npx shadcn add @amicro/presets

💻 Card Components & CLI Commands

Component Description CLI Command
ARC (5 Cards) Fanned card layout forming a neat curved arc with 5 items npx @subhanhq/amicro@latest add card-arc-5
ARC (7 Cards) Expanded card arc layout accommodating 7 items cleanly npx @subhanhq/amicro@latest add card-arc-7
Long ARC (5 Cards) Wide, sweeping card arc extending translations laterally npx @subhanhq/amicro@latest add card-long-arc-5
Linear Spread Slides cards horizontally in a linear row without rotations npx @subhanhq/amicro@latest add card-linear-spread
Corner Fan Fans elements radially from a fixed bottom-left origin anchor npx @subhanhq/amicro@latest add card-corner-fan
Stamp Arc Perforated stamp cards with dynamic arc, gap, and offset controls npx @subhanhq/amicro@latest add card-stamp-arc
Cascade Stagger Deploys cards vertically and staggered in a diagonal cascade npx @subhanhq/amicro@latest add card-cascade-stagger
Scatter Desk Deal Scatters cards into an overlapping dealt hand layout on hover npx @subhanhq/amicro@latest add card-scatter-spread
Wheel Radial Fan Fans cards outward in a radial semi-circle around center anchor npx @subhanhq/amicro@latest add card-wheel-fan
Interactive Carousel An interactive arc-based 3D motion carousel featuring smooth dot indicators and dynamic prev/next controls, inspired by vivi npx @subhanhq/amicro@latest add card-carousel
CoverFlow Carousel Premium 3D CoverFlow carousel displaying cards along perspective path npx @subhanhq/amicro@latest add card-cover-flow
Time Machine Stack Apple-style perspective depth card stack with timeline scrubber npx @subhanhq/amicro@latest add card-time-machine

✨ Key Features


🛠️ Prerequisites & Requirements


👤 Author & Support

Created with ❤️ by Syed Subhan


RepoStars

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

Monocharts (Subhan-code/Monocharts)

Searching Database…

Что это?Это отобранная коллекция премиальных React-компонентов микровзаимодействий, эффектов переходов и анимированных макетов карточек (называется @subhanhq/amicro), построенная поверх библиотеки анимации Motion.
Это npm-пакет, который я импортирую, или что-то другое?Это реестр компонентов, где код копируется прямо в проект, как в shadcn/ui: вы ставите CLI-команду, которая копирует исходный TSX-код компонента в ваш проект, вместо добавления runtime-зависимости.
Как добавить компонент в проект?Выполните CLI-команду вроде `npx @subhanhq/amicro@latest add card-arc-5` или настройте маппинг именованного реестра, добавив неймспейс @amicro в components.json вашего проекта, чтобы ставить компоненты по имени.
Что уже должно быть настроено в проекте для этих компонентов?Node.js 18 или выше, React 18 или 19, Tailwind CSS v3 или v4, а также пакет motion или framer-motion.
Будет ли работать, если я не использую Tailwind или Motion?Нет: компоненты рассчитаны на то, что Tailwind CSS и библиотека анимации Motion уже настроены в проекте, — они заявлены как обязательные требования.
Это только для веб-приложений?Да, это библиотека React UI-компонентов для веб-фронтендов, а не для нативных мобильных или десктопных приложений.
Какие компоненты сюда входят?В основном макеты карточек (веера дуг, каскады, карусели, стопки «машины времени») и микро-переходы, например дуга из 5 карточек, карусель в стиле CoverFlow и стопка карточек с перспективой в стиле Apple.
Почему код копируется в проект, а не импортируется через npm?Копирование TSX-исходников прямо в кодовую базу избавляет от добавления runtime-зависимостей и даёт полный контроль для доработки компонента после установки.
Поддерживается ли тёмная тема?Да, компоненты изначально спроектированы с расчётом и на тёмную, и на светлую палитру интерфейса.
Можно ли установить один компонент без CLI?Да, любой компонент можно установить и напрямую по его публичному raw-URL, не используя CLI-команду npx.
Size
1.5 MB
Stars
189
Updated
CommitAug 15
Age
2mo
Commits · 90 Days