Skip to content

stacherski/design-system

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

18 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

AS Design System

Status License Platform

A lightweight framework-agnostic design system built with native HTML, CSS and JavaScript. It provides reusable UI components and patterns for building consistent and maintainable interfaces without relying on external frameworks.

Live demo: https://as-design-system.netlify.app

Repository: https://github.com/stacherski/design-system


Overview

AS Design System is a collection of reusable UI components designed to standardize interface development across web projects.

Instead of repeatedly building UI elements from scratch, this design system provides a shared set of components and styling conventions that improve:

  • interface consistency
  • development speed
  • maintainability
  • reusability of UI patterns

The system is intentionally framework-independent so it can be used in:

  • plain HTML projects
  • static websites
  • CMS templates
  • JS frameworks (React, Vue, etc.)
  • internal tools and dashboards

Key Principles

Framework Agnostic Built using native browser technologies.

Lightweight Minimal code footprint and no runtime dependencies.

Reusable Components designed to work across multiple projects.

Consistent Shared design patterns reduce UI fragmentation.

Accessible by default Components are designed with accessibility considerations.


Demo

The demo page presents all available components and their visual behavior.

https://as-design-system.netlify.app

It can be used as:

  • a component reference
  • a development playground
  • a visual documentation page

Components

The design system includes UI elements commonly required in web interfaces.

Examples include:

  • buttons
  • forms
  • inputs
  • layout helpers
  • navigation patterns
  • UI utilities

More components will be added over time as the system evolves.


Getting Started

Clone the repository:

git clone https://github.com/stacherski/design-system.git
cd design-system

Open the demo page in your browser:

index.html

You can also run a local development server if preferred.


Usage

Include the required styles and scripts:

<link rel="stylesheet" href="css/styles.css">
<script src="js/components.js"></script>

Use components directly in your HTML:

<button class="ts-button ts-button-primary">
    Primary Button
</button>

Refer to the demo page for working examples and patterns.


Customization

The design system is intended to be easy to adapt.

Common customization options include:

  • modifying color tokens
  • adjusting spacing scale
  • extending existing components
  • overriding styles for branding

Because the system uses plain CSS, it can be customized without build tools.


Use Cases

AS Design System works well for:

  • internal admin tools
  • prototypes
  • dashboards
  • static websites
  • CMS-based projects
  • lightweight web apps

Contributing

Contributions are welcome.

Examples of useful contributions:

  • new components
  • accessibility improvements
  • bug fixes
  • performance improvements
  • documentation updates

Workflow:

  1. Fork the repository
  2. Create a feature branch
  3. Commit your changes
  4. Open a pull request

Roadmap

Possible future improvements:

  • additional UI components
  • design tokens
  • improved documentation
  • accessibility audits
  • component testing

License

This project is released under the MIT License.

See the LICENSE file for details.


Author

Created and maintained by Andrzej Stacherski

GitHub: https://github.com/stacherski

About

A lightweight framework-agnostic design system built with native HTML, CSS and JavaScript. It provides reusable UI components and patterns for building consistent and maintainable interfaces without relying on external frameworks.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors