https://github.com/propjockey/breakpoint-system
Highly accessible, responsive CSS designed in pixels and implemented 1:1 with the new Breakpoint Unit for a flawless fluid experience. Custom aliases, breakpoints, and queries with heavily researched defaults. No scripts, no builds, 100% vanilla CSS. Old tech, new ideas - 89% global user reach. Deliver your designs.
https://github.com/propjockey/breakpoint-system
breakpoints css mediaqueries responsive-design responsive-layout responsive-web-design
Last synced: about 2 months ago
JSON representation
Highly accessible, responsive CSS designed in pixels and implemented 1:1 with the new Breakpoint Unit for a flawless fluid experience. Custom aliases, breakpoints, and queries with heavily researched defaults. No scripts, no builds, 100% vanilla CSS. Old tech, new ideas - 89% global user reach. Deliver your designs.
- Host: GitHub
- URL: https://github.com/propjockey/breakpoint-system
- Owner: propjockey
- License: bsd-2-clause
- Created: 2026-04-18T01:43:54.000Z (2 months ago)
- Default Branch: main
- Last Pushed: 2026-04-23T03:44:59.000Z (2 months ago)
- Last Synced: 2026-04-23T05:28:55.592Z (2 months ago)
- Topics: breakpoints, css, mediaqueries, responsive-design, responsive-layout, responsive-web-design
- Language: CSS
- Homepage: https://propjockey.breakpoint-system.com/
- Size: 21.5 KB
- Stars: 2
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
[](http://jane.propjockey.io/)
# breakpoint-system from
PropJockey
Highly accessible, responsive CSS designed in pixels and implemented 1:1 with the new Breakpoint Unit for a flawless fluid experience. Custom aliases, breakpoints, and queries with heavily researched defaults. No scripts, no builds, 100% vanilla CSS. Old tech, new ideas - 89% global user reach. Deliver your designs.
Docs+Demos at: https://propjockey.breakpoint-system.com
NPM: https://www.npmjs.com/package/@propjockey/breakpoint-system
GitHub: https://github.com/propjockey/breakpoint-system
Install:
`$ npm install @propjockey/breakpoint-system`
Then import the `/node_modules/@propjockey/breakpoint-system/breakpoint-system.css` file into your project.
OR
Use your favorite NPM CDN and include it on your page for small projects. Like so:
```html
```
## πΈππ Browser Support (~89% global reach as of April, 2026)
The limiting factor for compatibility is the [CSS round() function](https://caniuse.com/mdn-css_types_round) and [CSS nesting selector](https://caniuse.com/mdn-css_selectors_nesting).
| Browser / Platform | Minimum Version | Date Supported | Global Share |
| :--- | :--- | :--- | :--- |
| **Safari / iOS Safari** | 16.5 | May 2023 | ~17.5% |
| **Firefox** | 128 | July 2024 | ~1.75% |
| **Chrome / Chrome for Android** | 138 | Jun 2025 | ~63.5% |
| **Edge** | 138 | Jun 2025 | ~5.5% |
| **Opera** | 122 | Sep 2025 | ~0.5% |
| **Total Unflagged Support** | | | **~89%** |
---
## β¨π½π The Magic
`@propjockey/breakpoint-system` is the first vanilla CSS library of its kind, with much to offer.
https://propjockey.breakpoint-system.com
### π οΈ 100% Customizable Querying
Our defaults are excellent, your needs are specific. You are not locked into our breakpoint sizes nor names. You can, optionally, define custom identifiers, aliases, and corresponding breakpoint locations.
### π Automatic Accessibility Scaling
Ten years ago author Zell Liew wrote about [several problems with responsive design](https://zellwk.com/blog/media-query-units/). Every point has long since been fixed by browsers except, arguably, the most important one:
`px` breakpoints don't respect users who require larger base font sizes and "blows out" the expected boundaries of your design.
Browsers didn't "fix" this because it's a CSS authoring problem - yet `px` is so common, it's [almost](https://propjockey.github.io/css-media-vars/) the only unit you'll ever see in a media query.
`@propjockey/breakpoint-system` fixes this for *everyone*, automatically.
Breakpoints are specified as numeric pixel values for *ease of DX* and automatically integrated into the engine relative to the root `em` determined by the user's system settings for *ease of UX*. π½π€π
Effectively, your mobile-friendly design now shows up instead of your tablet-friendly design to accomodate their larger font size preference, proportionately to the difference. It doesn't blow out your design, it just appears as if they zoomed into your mobile design in their tablet viewport without overflowing their screen.
*This is our default behavior, but it's optional.*
---
### π Fluid Design and Typography Built-In!
Deliver your designs. Perfect app-ready design and text scaling using our breakpoint units, `var(--bpu-16px)`, without ever trampling nor abusing your `rem` unit, [writing `clamp()`, or reiterating breakpoint boundaries](https://www.npmjs.com/package/fluid-text-plugin) again.
---
### π‘οΈ Bulletproof and Future-Ready
Our API uses simple calc() switches, space toggles, CSS Container Style Queries, or `if(style())` conditionals - your choice!
`@propjockey/breakpoint-system` is built with the future in heart, (like [some of our](https://augmented-ui.com/) [other products](https://propjockey.github.io/css-bin-bits/) [and ideas](https://dev.to/janeori/100-css-fetch-and-exfiltrate-512-bits-of-server-generated-data-embedded-in-an-animated-svg-5aad))!
---
Deliver your designs.
## CHANGELOG:
v1.1.1 - April 23rd, 2026:
* Added over 2700 query tests to the website (stress test too) https://propjockey.breakpoint-system.com/tests.html
* Fixed browser support for FF 128 and Safari 16.5 - 18.7 thanks to a generous month of BrowserStack from [@terzic](https://github.com/terzic)
* Corrected Chrome support, CSS abs() is its limiting factor (- 0.81% reach from initial mistake)
* Updated the library's root @supports statements to perfectly align with actual support
v1.1.0 - April 22nd, 2026:
* Made class names prefix--extensible by authors.
* Added query "in" space toggle opt-in expansion.
* Fixes for a currently-undocumented feature set.
v1.0.0 - April 17th, 2026:
* Initial release
---
## Open Contact π½
Please do reach out if you need help with any of this, have feature requests, or want to share what you've created!
| PropJockey | CodePen | DEV Blog | GitHub |
| :---: | :---: | :---: | :---: |
| [](https://propjockey.io) | [](https://codepen.io/propjockey) | [](https://dev.to/janeori) | [](https://github.com/propjockey) |
| Mastodon | LinkedIn | X | Bluesky |
| :---: | :---: | :---: | :---: |
| [](https://front-end.social/@JaneOri) | [](https://www.linkedin.com/in/janeori/) | [](https://x.com/jane0ri) | [](https://bsky.app/profile/janeori.propjockey.io) |
### My heart is open to receive abundance in all forms,
flowing to me in many expected and unexpected ways.
| PayPal | Ko-fi | Venmo |
| :---: | :---: | :---: |
| [](https://www.paypal.com/donate/?cmd=_s-xclick&hosted_button_id=9Z925L3SJJ8BS&source=qr&ssrt=1772865628068) | [](https://ko-fi.com/janeori) | [](https://account.venmo.com/u/JaneOri) |
| BTC | XRP | ETH |
| :---: | :---: | :---: |
| [](https://app.ens.domains/janeori.eth) | [](https://bithomp.com/en/account/X7zmKiqEhMznSXgj9cirEnD5sWo3iZPqbNPChdEKV9sM9WF) | [](https://app.ens.domains/janeori.eth) |
| bc1qe...usgn9 | rw2ci...nWKQg
: 459777128 | 0x674...beF54 |