@expressivecss/expressive 0.1.0-alpha.3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Javier Baez
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,82 @@
+# ExpressiveCSS
+
+A CSS framework inspired by Google's [Material Design 3 Expressive](https://material.io/) design language. Built on top of [MaterializeCSS v2.2.2](https://materializecss.github.io/materialize/), ExpressiveCSS aims to bring the expressive, dynamic, and personality-rich aesthetics of M3 Expressive to the web.
+
+> **Status: Early Alpha** — Actively under development. APIs and class names may change. Not yet recommended for production use.
+
+## Vision
+
+Google's M3 Expressive introduces a more vibrant, playful, and emotionally resonant layer to Material Design — prioritizing personality, motion, and visual richness. ExpressiveCSS brings that vision to a CSS framework you can drop into any project.
+
+The framework uses MaterializeCSS v2.2.2 as its foundation, which will be progressively updated and reshaped to match the M3 Expressive design language.
+
+## Project Structure
+
+```
+src/scss/
+├── materialize.scss          # Entry point
+├── foundation/               # Design tokens, theme, variables, color palette, mixins, normalize, base
+├── utilities/                # Colors, typography, elevation, spacing, responsive, helpers
+├── layout/                   # Grid, footer, table
+├── components/               # 28 UI components (buttons, cards, appbar, modal, etc.)
+└── forms/                    # Input fields, radio buttons, checkboxes, switches, select, file input, range
+```
+
+The framework loads in a layered dependency order: **foundation → utilities → layout → components → forms**, ensuring design tokens and variables are available before any component uses them.
+
+## Getting Started
+
+### Prerequisites
+
+- [Sass](https://sass-lang.com/) (Dart Sass recommended — uses the modern `@use`/`@forward` module system)
+
+### Installation
+
+Clone the repository:
+
+```bash
+git clone https://github.com/BaezFJ/ExpressiveCSS.git
+cd ExpressiveCSS
+```
+
+### Usage
+
+Import the full framework in your Sass file:
+
+```scss
+@use 'path/to/src/scss/materialize';
+```
+
+Or import only the layers you need:
+
+```scss
+@use 'path/to/src/scss/foundation';
+@use 'path/to/src/scss/utilities';
+@use 'path/to/src/scss/components';
+```
+
+### Compile
+
+```bash
+sass src/scss/materialize.scss dist/css/materialize.css
+```
+
+## Components
+
+ExpressiveCSS includes a wide range of UI components:
+
+**Layout** — Grid, Footer, Table
+
+**Components** — Buttons, Cards, Navbar, Tabs, Modal, Dropdown, Sidenav, Collapsible, Carousel, Slider, Tooltip, Toast, Chips, Badges, Collection, Breadcrumb, Pagination, Parallax, Preloader, Pulse, Tap Target, Date Picker, Time Picker, Table of Contents, Material Box, Material Icons, Video
+
+**Forms** — Input Fields, Radio Buttons, Checkboxes, Switches, Select, File Input, Range
+
+## Acknowledgments
+
+ExpressiveCSS is built on top of **[MaterializeCSS v2.2.2](https://materializecss.github.io/materialize/)**, a modern responsive front-end framework based on Material Design. We are grateful to the MaterializeCSS team and its contributors for providing the solid foundation that this project builds upon.
+
+MaterializeCSS is licensed under the [MIT License](https://github.com/nicholasgasior/materialize/blob/v2-dev/LICENSE).
+
+## License
+
+This project is licensed under the MIT License — see the [LICENSE](LICENSE) file for details.