Docs/PACKAGES/@gwenui/react

@gwenui/react

2D full-page blocks for React — shadcn/ui recolored with GwenUI tokens + Framer Motion animations.

Overview#

@gwenui/react is the main block library for GwenUI. It ships full-page 2D blocks built on top of shadcn/ui components, recolored with GwenUI design tokens and animated with Framer Motion.

Blocks in @gwenui/react are not installed from node_modules — they are copied into your project via the CLI. You own the code.

Installation#

Blocks are installed via the CLI:

gwen-ui add <block>

See add for full usage.

Available blocks#

BlockCategoryDescription
loginComponentsCinematic glassmorphic login screen with animated noise background
pricingComponentsModern three-tier glass card pricing system with floating feature lists
ai-chatComponentsSmooth streaming chat UI with liquid animations and markdown support
hyper-textText AnimationsScramble effect that cycles through characters before revealing the text
text-animateText AnimationsAnimate characters with staggered delays and premium easing effects
velocity-scrollText AnimationsKinetic typography that scrolls horizontally based on window scroll speed
letter-cascadeText AnimationsSpring-physics based letters that scatter dynamically with drag/hover
text-repelText AnimationsLetters that react dynamically and repel from the cursor
particle-typographyText AnimationsInteractive typographic art composed of dynamic organic particle systems
grainientHero BackgroundsPremium animated noise gradient backdrop with blend modes
solarisHero BackgroundsInteractive 3D/WebGL fluid shader background for landing pages
magnetic-buttonVisual EffectsMagnetic attraction button with custom chromatic aberration hover effect
glass-surfaceVisual EffectsCustom glassmorphic container with responsive shimmer highlights

More blocks are added regularly. Run gwen-ui add --list to see all available blocks.

Stack#

DependencyUsage
shadcn/uiAtomic component primitives
Framer MotionEntrance animations, interactions
Tailwind CSS v4Utility styling
Lucide ReactIcons

Status#

In active development. First blocks shipping soon. 🚧