style-forge/README.md

Style-Forge: Modular CSS framework with a powerful CLI for installing, building, and customizing atomic design modules.

# Style-Forge

![npm](https://img.shields.io/npm/v/style-forge)
![license](https://img.shields.io/npm/l/style-forge)
![npm](https://img.shields.io/npm/dm/style-forge)
![build](https://github.com/Style-Forge/hub/actions/workflows/release.yml/badge.svg)

`Style-Forge` is a modular CSS framework with a powerful CLI for installing, building, and customizing atomic design modules.  
It empowers developers to generate styles, manage themes, and control every layer of styling — from utilities to color systems — with full flexibility.

## 🚀 Quick Start

```bash
npx style-forge              # Interactive module installer and builder
```

Want to generate atomic HSL-based colors?

```bash
npx style-forge.colors       # Standalone color generator
```

## Documentation

To check out docs, visit [style-forge.github.io](https://style-forge.github.io/).

## Support the project ⭐

If you feel awesome and want to support us in a small way, please consider starring and sharing the repo! This helps us getting known and grow the community. 🙏

<img src="https://github.com/style-forge/hub/raw/main/public/github-star.gif" alt="style-forge-star" />

## Contributing

If you would like to contribute, please refer to the contributing guidelines in the following repositories:

<table>
  <tr>
    <th>Module</th>
    <th colspan="2">Links</th>
    <th>Version</th>
    <th>Description</th>
  </tr>
  <tr>
    <td>hub</td>
    <td><a href="https://github.com/Style-Forge/hub" target="_blank">GitHub</a></td>
    <td><a href="https://npmjs.com/package/style-forge" target="_blank">NPM</a></td>
    <td><img src="https://img.shields.io/npm/v/style-forge" alt="npm"></td>
    <td>Central repository that integrates all project modules.</td>
  </tr>
  <tr>
    <td>base</td>
    <td><a href="https://github.com/Style-Forge/base" target="_blank">GitHub</a></td>
    <td><a href="https://npmjs.com/package/style-forge.base" target="_blank">NPM</a></td>
    <td><img src="https://img.shields.io/npm/v/style-forge.base" alt="npm"></td>
    <td>Basic styles and foundational components of the project.</td>
  </tr>
  <tr>
    <td>form</td>
    <td><a href="https://github.com/Style-Forge/form" target="_blank">GitHub</a></td>
    <td><a href="https://npmjs.com/package/style-forge.form" target="_blank">NPM</a></td>
    <td><img src="https://img.shields.io/npm/v/style-forge.form" alt="npm"></td>
    <td>Styles and components for creating forms.</td>
  </tr>
  <tr>
    <td>helpers</td>
    <td><a href="https://github.com/Style-Forge/helpers" target="_blank">GitHub</a></td>
    <td><a href="https://npmjs.com/package/style-forge.helpers" target="_blank">NPM</a></td>
    <td><img src="https://img.shields.io/npm/v/style-forge.helpers" alt="npm"></td>
    <td>Utility functions and helpers for the project.</td>
  </tr>
  <tr>
    <td>└&nbsp;media</td>
    <td><a href="https://github.com/Style-Forge/media" target="_blank">GitHub</a></td>
    <td><a href="https://npmjs.com/package/style-forge.media" target="_blank">NPM</a></td>
    <td><img src="https://img.shields.io/npm/v/style-forge.media" alt="npm"></td>
    <td>Comprehensive CSS media query helpers for responsive web design.</td>
  </tr>
  <tr>
    <td>themes</td>
    <td><a href="https://github.com/Style-Forge/themes" target="_blank">GitHub</a></td>
    <td><a href="https://npmjs.com/package/style-forge.themes" target="_blank">NPM</a></td>
    <td><img src="https://img.shields.io/npm/v/style-forge.themes" alt="npm"></td>
    <td>Themes and styling options for the project.</td>
  </tr>
  <tr>
    <td>patterns</td>
    <td><a href="https://github.com/Style-Forge/patterns" target="_blank">GitHub</a></td>
    <td><a href="https://npmjs.com/package/style-forge.patterns" target="_blank">NPM</a></td>
    <td><img src="https://img.shields.io/npm/v/style-forge.patterns" alt="npm"></td>
    <td>Reusable patterns and templates for the project.</td>
  </tr>
  <tr>
    <td>colors</td>
    <td><a href="https://github.com/Style-Forge/colors" target="_blank">GitHub</a></td>
    <td><a href="https://npmjs.com/package/style-forge.colors" target="_blank">NPM</a></td>
    <td><img src="https://img.shields.io/npm/v/style-forge.colors" alt="npm"></td>
    <td>Atomic HSL-based color generator and palette engine.</td>
  </tr>
</table>

## License

This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.