maxsite/berry

Purpose and deliverables

Berry is a Sass-authored CSS utility/framework library. Its repository delivers prebuilt stylesheets for direct consumption and the modular Sass source for customization: css/berry.css, css/berry-format.css, and sass/berry.scss.

Primary entry points

sass/berry.scss is the source composition root: consumers compile it through a Sass implementation to produce a complete Berry stylesheet. css/berry.css is the general compiled distribution, while css/berry-format.css is a separate precompiled format-oriented variant. There is no application runtime, server, or executable entry point.

Sass composition boundary

The source is organized around Sass partial imports under sass/berry/. The top-level entry point assembles configurable defaults and module indexes, making module directories the principal dependency boundary. sass/berry/_style.scss is the core style aggregation layer; category _index.scss files expose each module family, such as sass/berry/modules/reset/_index.scss and sass/berry/modules/utilities/_index.scss.

Configuration and design tokens

Central configuration partials define the values used by downstream generated rules, separating policy from emitted CSS. Key inputs are sass/berry/config/_typography.scss, sass/berry/config/_buttons.scss, and sass/berry/config/_utilities.scss. Changes here propagate during Sass compilation into typography, component, and utility output.

Baseline and typography stages

The reset stage establishes cross-browser baseline behavior through sass/berry/modules/reset/_normalize.scss and sass/berry/modules/reset/_border-box.scss. Typography then defines root, base element, content-block, and print styles via sass/berry/modules/typography/_root.scss, sass/berry/modules/typography/_base.scss, and sass/berry/modules/typography/_print.scss. This layer is foundational; utilities and design modules assume these baseline conventions.

Design components

The design module supplies opinionated element/component styling, especially forms and buttons. Its public assembly is sass/berry/modules/design/_index.scss, backed by sass/berry/modules/design/_buttons.scss and sass/berry/modules/design/_forms.scss. Default variants are separately represented, allowing the library to distinguish reusable structural rules from its default visual treatment.

Utility generation layer

Utility partials provide composable classes for layout, responsive-like sizing primitives, visual effects, and interaction/display behavior. The aggregation point is sass/berry/modules/utilities/_index.scss; major domains include sass/berry/modules/utilities/_flex.scss, sass/berry/modules/utilities/_grid.scss, and sass/berry/modules/utilities/_padding-margin.scss. These consume shared configuration and are intended to be used directly in markup after compilation.

Optional/demo and external dependencies

Demo-specific CSS is isolated under sass/berry/modules/demo/_index.scss, keeping demonstration/template styling separate from the framework’s core layers. The only material build dependency is a Sass compiler; the repository declares no backend infrastructure, client-side JavaScript runtime, package manager metadata, or external service integration. Documentation is hosted externally at https://maxsite.org/berry.