PHPackages                             helsingborg-stad/styleguide - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility &amp; Helpers](/categories/utility)
4. /
5. helsingborg-stad/styleguide

ActiveLibrary[Utility &amp; Helpers](/categories/utility)

helsingborg-stad/styleguide
===========================

2.202.16(1mo ago)5230↓50%5[16 PRs](https://github.com/helsingborg-stad/styleguide/pulls)MITSCSSPHP ^8.2CI failing

Since Mar 22Pushed 1mo ago8 watchersCompare

[ Source](https://github.com/helsingborg-stad/styleguide)[ Packagist](https://packagist.org/packages/helsingborg-stad/styleguide)[ RSS](/packages/helsingborg-stad-styleguide/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (10)Dependencies (9)Versions (1808)Used By (0)

[![Contributors](https://camo.githubusercontent.com/f8998baaf9d637983c75ff57d560340a7248bd0c0374778909474bfdbcd9e690/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f636f6e7472696275746f72732f68656c73696e67626f72672d737461642f7374796c6567756964652e7376673f7374796c653d666c61742d737175617265)](https://github.com/helsingborg-stad/styleguide/graphs/contributors)[![Forks](https://camo.githubusercontent.com/dd8c85f73a80aa181f5353d185e73227f7b5d1fd0cc8ad68818446b051e49f98/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f666f726b732f68656c73696e67626f72672d737461642f7374796c6567756964652e7376673f7374796c653d666c61742d737175617265)](https://github.com/helsingborg-stad/styleguide/network/members)[![Stargazers](https://camo.githubusercontent.com/0f922bae7d0dbd0a85a1415cda4b3fae6e6cf44f6540e24f24d982328d6977ab/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f73746172732f68656c73696e67626f72672d737461642f7374796c6567756964652e7376673f7374796c653d666c61742d737175617265)](https://github.com/helsingborg-stad/styleguide/stargazers)[![Issues](https://camo.githubusercontent.com/924225f30733ea91c3f09f1c631fdb39bd2b88db5c255a322953bdf02573c06f/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6973737565732f68656c73696e67626f72672d737461642f7374796c6567756964652e7376673f7374796c653d666c61742d737175617265)](https://github.com/helsingborg-stad/styleguide/issues)[![License](https://camo.githubusercontent.com/10d4543bdc3ea470f8f1f3a65505841fcbb0332b1a52c4bb87132e523e17e974/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f68656c73696e67626f72672d737461642f7374796c6567756964652e7376673f7374796c653d666c61742d737175617265)](https://raw.githubusercontent.com/helsingborg-stad/styleguide/master/LICENSE)

 [ ![Logo](docs/images/hbg-github-logo-combo.png) ](https://github.com/helsingborg-stad/styleguide)

Styleguide
==========

[](#styleguide)

 [Report Bug](https://github.com/helsingborg-stad/styleguide/issues) · [Request Feature](https://github.com/helsingborg-stad/styleguide/issues)

Summary
-------

[](#summary)

The style guide is intended for websites within Helsingborgs stad / Municipio Websites and others who use our platform. The guide provides examples, markup and themes for our standardized components. The Helsingborg Styleguide is a flexible and minimalistic component-based framework built in the BEM standard &amp; designed around the Atomic Design principle.

### Requirements

[](#requirements)

- NodeJS &gt;= 16
- PHP &gt;= 8
- [Composer](https://getcomposer.org/)

Installation
------------

[](#installation)

1. Clone the repo:

```
git clone git@github.com:helsingborg-stad/styleguide.git
```

2. Run the build script in the cloned project:

```
cd styleguide && php build.php
```

Development
-----------

[](#development)

1. Start by running the steps under [Installation](#installation).
2. Run webpack in watch-mode:

```
npm run watch
```

Testing
-------

[](#testing)

Jest is used as testing framework for JavaScript in the StyleGuide.

Test files should be added adjacent to the file that is the subject fo testing. Naming convention for test files is to use the same name as the file that is subject for testing and be appended with ".test.js" or "test.ts". The ".ts" file ending enables some IDE's, like VS Code, to add intellisense for Jest.

### Example file accompanied by test file

[](#example-file-accompanied-by-test-file)

```
source/js
├── gallery.js
├── gallery.test.ts

```

### Test scripts

[](#test-scripts)

- Run tests: ```
    npm test
    ```
- Runs tests in file watch mode: ```
    npm run test:dev
    ```

VS Code Devcontainer &amp; Codespaces
-------------------------------------

[](#vs-code-devcontainer--codespaces)

Configuration for Codespaces is available and to get it up and running do the following after opening a Codespace:

1. Run task `Setup`.
2. Run task `Serve`.

License
-------

[](#license)

Distributed under the [MIT License](https://raw.githubusercontent.com/helsingborg-stad/styleguide/master/LICENSE).

Acknowledgements
----------------

[](#acknowledgements)

- [othneildrew Best README Template](https://github.com/othneildrew/Best-README-Template)

###  Health Score

62

—

FairBetter than 99% of packages

Maintenance92

Actively maintained with recent releases

Popularity24

Limited adoption so far

Community25

Small or concentrated contributor base

Maturity92

Battle-tested with a long release history

 Bus Factor2

2 contributors hold 50%+ of commits

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~1 days

Total

1602

Last Release

43d ago

Major Versions

v0.11.1397 → 2.190.32026-03-16

v0.11.1398 → 2.194.102026-03-19

v0.11.1399 → 2.197.22026-03-19

v0.11.1400 → 2.197.42026-03-19

v0.11.1402 → 2.198.462026-03-26

PHP version history (2 changes)v0.11.1014PHP ^8.0

2.152.3PHP ^8.2

### Community

Maintainers

![](https://www.gravatar.com/avatar/f46fe64973c3e89d15c745c0bf601c25983bafea81d30e64d4bf813a6f8c8c7c?d=identicon)[sebastianthulin](/maintainers/sebastianthulin)

---

Top Contributors

[![actions-user](https://avatars.githubusercontent.com/u/65916846?v=4)](https://github.com/actions-user "actions-user (1387 commits)")[![silvergrund](https://avatars.githubusercontent.com/u/4200504?v=4)](https://github.com/silvergrund "silvergrund (722 commits)")[![NiclasNorin](https://avatars.githubusercontent.com/u/103985736?v=4)](https://github.com/NiclasNorin "NiclasNorin (636 commits)")[![alexanderbomanskoug2](https://avatars.githubusercontent.com/u/39676080?v=4)](https://github.com/alexanderbomanskoug2 "alexanderbomanskoug2 (366 commits)")[![ergr1001](https://avatars.githubusercontent.com/u/97021637?v=4)](https://github.com/ergr1001 "ergr1001 (202 commits)")[![cedrikvonheiroth](https://avatars.githubusercontent.com/u/64852452?v=4)](https://github.com/cedrikvonheiroth "cedrikvonheiroth (117 commits)")[![nRamstedt](https://avatars.githubusercontent.com/u/16800993?v=4)](https://github.com/nRamstedt "nRamstedt (91 commits)")[![Muckbuck](https://avatars.githubusercontent.com/u/11438804?v=4)](https://github.com/Muckbuck "Muckbuck (80 commits)")[![faejr](https://avatars.githubusercontent.com/u/752642?v=4)](https://github.com/faejr "faejr (80 commits)")[![sebastianthulin](https://avatars.githubusercontent.com/u/797129?v=4)](https://github.com/sebastianthulin "sebastianthulin (72 commits)")[![thorbrink](https://avatars.githubusercontent.com/u/1064724?v=4)](https://github.com/thorbrink "thorbrink (57 commits)")[![annalinneajohansson82](https://avatars.githubusercontent.com/u/232372534?v=4)](https://github.com/annalinneajohansson82 "annalinneajohansson82 (42 commits)")[![jonatanhanson](https://avatars.githubusercontent.com/u/21363149?v=4)](https://github.com/jonatanhanson "jonatanhanson (15 commits)")[![michaelclaesson](https://avatars.githubusercontent.com/u/18331514?v=4)](https://github.com/michaelclaesson "michaelclaesson (11 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (8 commits)")[![malinkytta](https://avatars.githubusercontent.com/u/113056103?v=4)](https://github.com/malinkytta "malinkytta (6 commits)")[![yo-l1982](https://avatars.githubusercontent.com/u/154269?v=4)](https://github.com/yo-l1982 "yo-l1982 (5 commits)")[![mikael-stromgren](https://avatars.githubusercontent.com/u/8775561?v=4)](https://github.com/mikael-stromgren "mikael-stromgren (3 commits)")[![rubikuo](https://avatars.githubusercontent.com/u/46818235?v=4)](https://github.com/rubikuo "rubikuo (3 commits)")[![AlexAlterya](https://avatars.githubusercontent.com/u/128726787?v=4)](https://github.com/AlexAlterya "AlexAlterya (2 commits)")

---

Tags

hacktoberfestnodejsphpscss

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/helsingborg-stad-styleguide/health.svg)

```
[![Health](https://phpackages.com/badges/helsingborg-stad-styleguide/health.svg)](https://phpackages.com/packages/helsingborg-stad-styleguide)
```

###  Alternatives

[pocketmine/pocketmine-mp

A server software for Minecraft: Bedrock Edition written in PHP

3.5k74.6k86](/packages/pocketmine-pocketmine-mp)[afragen/git-updater

A plugin to automatically update GitHub, Bitbucket, GitLab, or Gitea hosted plugins, themes, and language packs.

3.3k1.6k](/packages/afragen-git-updater)[firefly-iii/data-importer

Firefly III Data Import Tool.

7545.8k](/packages/firefly-iii-data-importer)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
