Card

A container component with ASCII borders for organizing and grouping related content.

Docs•API Reference
Welcome

Welcome to React ASCII UI! This is a card component with a title.

No Title Card

This card doesn't have a title prop, so you can add your own header.

Installation

npm install react-ascii-ui

Usage

import { AsciiCard, AsciiButton } from 'react-ascii-ui';

export default function Example() {
  return (
    <AsciiCard title="User Profile">
      <p>Welcome back, User!</p>
      <AsciiButton>Edit Profile</AsciiButton>
    </AsciiCard>
  );
}

Examples

Basic Card

This is a basic card without a title.

<AsciiCard>
  <p>This is a basic card without a title.</p>
</AsciiCard>

Card with Title

[ SYSTEM STATUS ]

All systems operational.

<AsciiCard title="[ SYSTEM STATUS ]">
  <p>All systems operational.</p>
</AsciiCard>

Card with Form Elements

Login
<AsciiCard title="Login">
  <div style={{ display: 'flex', flexDirection: 'column', gap: '15px' }}>
    <AsciiInput placeholder="Username" />
    <AsciiInput type="password" placeholder="Password" />
    <AsciiButton>Sign In</AsciiButton>
  </div>
</AsciiCard>

Card Grid

CPU
45%
Usage
RAM
78%
Usage
DISK
92%
Usage
<div style={{ display: 'grid', gridTemplateColumns: 'repeat(auto-fit, minmax(200px, 1fr))', gap: '20px' }}>
  <AsciiCard title="CPU">
    <div style={{ color: '#00ff00', fontSize: '24px' }}>45%</div>
    <div style={{ color: '#ccc', fontSize: '12px' }}>Usage</div>
  </AsciiCard>
  <AsciiCard title="RAM">
    <div style={{ color: '#ffaa00', fontSize: '24px' }}>78%</div>
    <div style={{ color: '#ccc', fontSize: '12px' }}>Usage</div>
  </AsciiCard>
  <AsciiCard title="DISK">
    <div style={{ color: '#ff4444', fontSize: '24px' }}>92%</div>
    <div style={{ color: '#ccc', fontSize: '12px' }}>Usage</div>
  </AsciiCard>
</div>

API Reference

Props

PropTypeDefaultDescription
titlestring-Optional title displayed at the top of the card
childrenReact.ReactNode-The content of the card
classNamestring-Additional CSS classes
styleReact.CSSProperties-Inline styles

AsciiCard extends all HTML div attributes and React.HTMLAttributes<HTMLDivElement>.