An open-source entry in TopGit's GitHub warehouse: kriasoft/isomorphic-style-loader, 1.3k stars, JavaScript. CSS style loader for Webpack that is optimized for isomorphic (universal) web apps.
Snapshot summary built from the project's own GitHub metadata — there's no written TopGit review yet. The page will update automatically when a full review is published.
WHY NO REVIEW YET
TopGit writes full reviews for the most-starred, most-requested repositories. This page is a snapshot until then — see the READ ME tab for the original README in full.
CSS style loader for Webpack that works similarly to
style-loader, but is optimized for
critical path CSS
rendering and also works great in the context of
isomorphic apps.
It provides two helper methods on to the styles object - ._insertCss()
(injects CSS into the DOM) and ._getCss() (returns a CSS string).
See getting started | changelog |
Join #isomorphic-style-loader
chat room on Discord to stay up to date
How to Install
$ npm install isomorphic-style-loader --save-dev
Requirements
Webpack 5
React 16.8 or newer
css-loader configured with esModule: false (the loader reads CSS module
class names from exports.locals)
The optional getCss loader option is serialized into the generated module,
so it must be a self-contained function without closed-over variables.
Breaking Changes in v6
Static properties of the wrapped component (e.g. fetchData) are no longer
hoisted onto the component returned by withStyles. Access them via the
ComposedComponent property instead.
/* App.js */
import React from 'react'
import withStyles from 'isomorphic-style-loader/withStyles'
import s from './App.scss'
function App(props, context) {
return (
<div className={s.root}>
<h1 className={s.title}>Hello, world!</h1>
</div>
)
}
export default withStyles(s)(App) // <--
P.S.: It works great with CSS Modules!
Just decorate your React component with the
withStyles
higher-order component, and pass a function to your React app via insertCss
context variable (see React's context API)
that either calls styles._insertCss() on a client or styles._getCss()
on the server. See server-side rendering example below:
import express from 'express'
import React from 'react'
import ReactDOM from 'react-dom'
import StyleContext from 'isomorphic-style-loader/StyleContext'
import App from './App.js'
const server = express()
const port = process.env.PORT || 3000
// Server-side rendering of the React app
server.get('*', (req, res, next) => {
const css = new Set() // CSS for all rendered React components
const insertCss = (...styles) => styles.forEach(style => css.add(style._getCss()))
const body = ReactDOM.renderToString(
<StyleContext.Provider value={{ insertCss }}>
<App />
</StyleContext.Provider>
)
const html = `<!doctype html>
<html>
<head>
<script src="client.js" defer></script>
<style>${[...css].join('')}</style>
</head>
<body>
<div id="root">${body}</div>
</body>
</html>`
res.status(200).send(html)
})
server.listen(port, () => {
console.log(`Node.js app is running at http://localhost:${port}/`)
})
It should generate an HTML output similar to this one:
Regardless of how many styles components there are in the app.js bundle,
only critical CSS is going to be rendered on the server inside the <head>
section of HTML document. Critical CSS is what actually used on the
requested web page, effectively dealing with
FOUC
issue and improving client-side performance.
CSS of the unmounted components will be removed from the DOM.
Then on client-side use hydrate
to make your markup interactive:
You can also use useStyles inside your React Functional Components, instead of using withStyles.
Please note that you still need to pass insertCss function to StyleContext.Provider from top of the tree.
import React from 'react'
import useStyles from 'isomorphic-style-loader/useStyles'
import s from './App.scss'
const App = (props) => {
useStyles(s);
return (
<div className={s.root}>
<h1 className={s.title}>Hello, world!</h1>
</div>
)
};
export default App;
Does kriasoft/isomorphic-style-loader have any tags?
TopGit's last sync did not record any GitHub topics for kriasoft/isomorphic-style-loader. GitHub topics appear in the right sidebar of a repository page; that's the authoritative place to check.
How active is development on kriasoft/isomorphic-style-loader?
The most recent commit recorded on kriasoft/isomorphic-style-loader was 2 months ago, based on the GitHub push timestamp. The repository has 140 forks — one of the better signals of community interest.
Is kriasoft/isomorphic-style-loader open source?
Yes — kriasoft/isomorphic-style-loader ships under the MIT license, which makes its source code freely readable (and, depending on license terms, forkable and reusable). Source: github.com/kriasoft/isomorphic-style-loader.
What license does kriasoft/isomorphic-style-loader use?
kriasoft/isomorphic-style-loader is released under the MIT license. Always verify the LICENSE file directly on GitHub for the authoritative terms — license strings can be edited out of sync with a project's actual stance.
Where can I see kriasoft/isomorphic-style-loader in action?
The project maintains a homepage at https://reactstarter.com. The README tab on this page also usually contains screenshots and a quickstart.
Where do I read more about kriasoft/isomorphic-style-loader?
This TopGit page is a snapshot — the READ ME tab shows the project's own README content (links stripped, images preserved). The GitHub repository at github.com/kriasoft/isomorphic-style-loader is the definitive source.
Read full README in the tab above.
Still deciding about isomorphic-style-loader?
One click hands the question to an AI along with this page — see what it says about isomorphic-style-loader.