Skip to content

Latest commit

 

History

9 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 

Repository files navigation

SuperRoundedUI (SRUI)

Flat never felt this round.

SuperRoundedUI is a pure-CSS design system created by Allwaysever that combines warmth, friendliness, and efficiency—without a single line of JavaScript in its core. It is exclusively optimized for Dark Environment, delivering a visually immersive and comfortable experience.


✨ Features

· Pure CSS — No JavaScript dependencies · Dark-only theme — Exclusively designed for dark environments · Super rounded corners — Consistent border-radius from 12px to 25px · GlassLayer effects — Soft transparency with backdrop blur · Micro-bounce interactions — Scale-based press & hover effects · Iconography ready — Material Symbols Rounded + Font Awesome Brands · Accessibility first — AAA contrast ratio compliance · Fully customizable — Via CSS custom properties


🚀 Quick Start

1. Include Core CSS Files

<link rel="stylesheet" href="srui-base.css" />
<link rel="stylesheet" href="srui-variables.css" />
<link rel="stylesheet" href="srui-utilities.css" />

2. Load Icons

<!-- Material Symbols Rounded (required) -->
<link href="https://fonts.googleapis.com/css2?family=Material+Symbols+Rounded:opsz,wght,FILL,GRAD@20..48,100..700,0..1,-50..200" rel="stylesheet" />

<!-- Font Awesome Brands (optional) -->
<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.0.0-beta3/css/brands.min.css" />

3. Basic Usage

<div class="srui-glass" style="max-width: 400px; margin: 2rem auto; padding: var(--srui-space-6);">
  <h2 style="font-weight: var(--srui-font-weight-bold);">Welcome</h2>
  <p class="srui-text-secondary">This is a GlassLayer card with content.</p>

  <button class="srui-pressed srui-chip srui-chip--accent" style="margin-top: 1rem;">
    <span class="material-symbols-rounded" style="font-size:20px; margin-right: 0.5rem;">arrow_forward</span>
    Get Started
  </button>
</div>

🎨 Core Design Principles

Principle Implementation

Fluent in Form Clean layouts, logical navigation, smooth transitions Material in Soul Minimal shadows, usability-focused, responsive iOS in Flatness Content-first, clean typography, dark whitespace Super Rounded Touch Consistently rounded interactive elements


🎯 Utility Classes

Class Purpose

.srui-card Card surfaces with rounded corners & shadow .srui-glass GlassLayer with blur effect .srui-chip Pill-shaped chips .srui-chip--accent Accent-colored chip .srui-pressed Interactive elements with scale effect .srui-text-body Primary text styling .srui-text-secondary Secondary text .srui-text-tertiary Tertiary text .srui-icon-sm/md/lg Icon sizing utilities


###🎯 Iconography

· UI Icons: Material Symbols Rounded (required) · Brand Logos: Font Awesome Brands ONLY (brands.min.css) · Sizes: 16px (inline), 20px (buttons), 24px (decorative) · Touch target: Minimum 44×44px


🎨 Theming & Customization

Change Accent Color

:root {
  --srui-accent: #ff5722;
  --srui-accent-text: #000000;
}

Change Primary Font

@import url('https://fonts.googleapis.com/css2?family=Nunito:wght@400;500;700&display=swap');

:root {
  --srui-font-primary: 'Nunito', 'Arial', sans-serif;
}

📦 Design Tokens

Colors

Variable Value Role --srui-accent #ffce00 CTA, highlights --srui-background #1B1C1E Main canvas --srui-card #0f0f0f Cards, chat bubbles --srui-text #ffffff Primary text --srui-text-secondary #999999 Secondary text --srui-border #4B4F50 Inputs, dividers

Radius

Variable Value --srui-radius-sm 12px --srui-radius-md 15px --srui-radius-lg 25px --srui-radius-pill 9999px

Spacing (4px scale)

--srui-space-1 (4px) through --srui-space-12 (48px)


⚠️ Prohibited Changes

· ❌ Light theme or light color variables · ❌ Full Font Awesome library (use brands.min.css only) · ❌ Changing --srui-background, --srui-text, --srui-card to light colors · ❌ Removing shadow or using radius less than --srui-radius-sm on interactive elements · ❌ Moving shadow on press effects


📄 License

Allwaysever Custom License Exclusive Projects Edition (ACLEPs Edition) Exclusively for projects that honor the dark exclusivity pact.


🤝 Contributing

Contributions of additional pure-CSS components are welcome, as long as they don't conflict with core principles (dark, rounded, flat shadow).


📝 Changelog

This README is updated annually. For detailed updates, refer to the GUIDELINES.docx document.


Flat never felt this round. | Allwaysever Projects

About

ff

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors