Skip to content

drproject-coding/doctor-project-design-system

Repository files navigation

DoctorProject Design System

A brutalist, framework-agnostic design system with offset shadows, high contrast, and a 4px grid.

Packages

Package Description
/css Core CSS — tokens, typography, buttons, forms, layout, utilities
/packages/react React component library with Storybook

Quick Start (CSS only)

<link rel="stylesheet" href="css/index.css" />
<script src="js/dark-mode.js"></script>

Quick Start (React)

cd packages/react
npm install
npm run storybook

CSS File Reference

File Contents
tokens.css CSS custom properties (colors, spacing, shadows, motion, z-index)
typography.css @font-face declarations, heading/text/label classes
buttons.css Button variants (primary, outline, ghost, danger, dark), sizes, groups
forms.css Input, select, checkbox, radio, switch, counter, form layouts
tags.css Tabs, tags, badges, progress bars, status dots
cards.css Card variants (raised, flat, interactive), color accents
tables.css Table styling with header, rows, hover
modals.css Overlay backdrop, modal with header/body/footer
pagination.css Pagination variants (default, dark, transparent)
layout.css App shell (sidebar, topbar, main content, footer, mobile)
utilities.css Flex, grid, spacing, text, backgrounds, dividers, empty states
responsive.css Breakpoints (1200/1024/768/600/390px), print styles

React Components

UI Components

Button, Input, Select, Radio, Checkbox, Switch, Tag, Badge, Card, Table, Modal, Pagination, Tabs, Toast, Spinner, Loader, Dropzone, Testimonial, FeatureList, CtaBanner

Typography

Heading, Text, Icon (24 icons), Pictogram (68 NeoBrutalist color SVGs)

Navigation

Sidebar (collapsible, sections, badges, team members), TopBar (title, actions, menu button)

Screens (full-page layouts)

Dashboard, Accounts, Payments, Transactions, Reports, Education, Support, Calendar, Contacts, Customers, Inbox, Products, Sales, ProfileSettings (Account, Security, Social, Notifications)

Shared Layout Components

AppSidebar, AppTopBar, AppFooter — single source of truth used by all screens. Update once, propagates everywhere.

Selective Import (CSS)

@import "css/tokens.css";
@import "css/typography.css";
@import "css/buttons.css";

Dark Mode

<script src="js/dark-mode.js"></script>
<button id="darkModeToggle">Toggle Dark Mode</button>
<script>
  darkModeManager.setupToggleButton("darkModeToggle");
</script>

Design Principles

  • Brutalist aesthetics: sharp corners, thick 2px borders, no gradients
  • Offset shadows: black, no blur (signature look)
  • High contrast: black on white, white on black
  • 4px grid spacing system
  • Dark mode built in via CSS custom properties
  • Framework-agnostic: works with React, Vue, vanilla, anything

Color Palette

Primary purple (#AE7AFF), plus secondary pastels (yellow, pink, mint).

Fonts

Visby (primary brand font) + Roboto Flex (fallback).

License

MIT

About

Brutalist, framework-agnostic design system — vanilla CSS + HTML. Offset shadows, thick borders, 4px grid, dark mode, Chart.js integration.

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors