v6.0.0

[ovidiuch]

React Cosmos 6 is a huge release that's been two years in the making!

The first 6.x beta version was released 8 months ago, giving us plenty of time to gather user feedback and refine this release into the most robust version of React Cosmos we've ever made.

What's New?

• A full-stack plugin system that enables bundler integrations and extending every aspect of React Cosmos.
• A brand new documentation website that covers everything from setup guides, detailed APIs and advanced configuration.
• Mature plugins for Vite and Webpack, dedicated APIs for React Native and Next.js, and support for custom setups.
• First-class support for React Server Components. Yes, you can render server-side code in React Cosmos!
• Lazy Mode, which delays importing component code until loading a fixture, greatly improving isolation by the flip of a switch.
• Support for MDX Fixtures.
• A revamped codebase with reduced dependencies and a CI with great test coverage migrated to GitHub Actions.

This is a foundational release that unlocks many upcoming features, so stay tunned.

We're also retiring our iconic Cosmonaut and inaugurating of our fresh new Cosmos logo designed by Pascal Graf.

Join us on Discord

Breaking Changes

• Dropped support for IE, Node 14 and React 17.
• React Cosmos 5.x users need to install the Webpack plugin to continue using React Cosmos with Webpack.
• Renamed a few less-known exports and package entry points.

More details in the migration guide: https://reactcosmos.org/docs/migration-guide

New Contributors

• @fauxparse made their first contribution in allow copy to clipboard from playground #1388
• @ifeanyiecheruo made their first contribution in Upgrade react-element-to-jsx-string dependency to allow react 18 peer dependency #1394
• @quassnoi made their first contribution in Increase awareness of the ability to override Webpack config #1437
• @lr0pb made their first contribution in Fix flag for generating userdeps in custom build setup guide #1450
• @noahehall made their first contribution in Chore(cosmos-ui): enable fullscreen permission on RendererPreview iframe #1530
• @kmjennison made their first contribution in Support secure websocket connections #1537
• @akramscorado made their first contribution in Add Next.js sub folder documentation #1546
• @ThaisRobba made their first contribution in feat: add fixture filename support #1559

Full Change Log

a687430 Mark getFixtures API as experimental (#1603)
f61f2b6 Upgrade dependencies and remove pkg-up (#1602)
da8b95e Improve Community Standards (#1601)
86b9647 Fix commit prefix
3cfdcfd Publish website on release commits (#1600)
f128af2 Simplify keyboard shortcuts (#1599)
561b52a Update app favicon and docs links (#1598)
50fdd73 Remove old website (#1597)
55752ef Add OpenGraph tags to website (#1596)
11ad824 Add .ico favicon and update logo (#1595)
10c9ae9 Add link to UI features on homepage (#1594)
c86a8ee Add benefits to homepage (#1593)
d60c866 Improve docs readability (#1592)
c00ca07 Ignore ts-node warnings (#1591)
01bd836 Add features to home page (#1590)
17b8ccb Add architecture docs (#1589)
c9d42ed Add table with config options to docs (#1588)
f94afb4 Prevent auto opening Cosmos renderer in browser (#1587)
595c147 Add instructions for installing Vite (#1586)
c2e10cc Improve plugin docs (#1585)
1e61d98 Improve fixture modules and useValue docs (#1584)
9af8fcb Add useFixtureState example in docs (#1583)
6d24901 Isolate fixture state between plugins (#1581)
f5c981a Clean up old TS component return type workaround (#1582)
28d8672 Allow UI plugins to extend initial fixture state (#1579)
2610c0f Fix loading of 3rd party UI plugins (#1578)
50a9804 Fix React Native for Web link
0d38d4a Upgrade dependencies (#1566)
1d2b9f6 Exclude test helpers from react-cosmos-ui index (#1576)
7332ee1 Upgrade Lerna
0f025d1 Don't collapse unnamed fixture on fileDir tree node (#1575)
18af053 Add fixture filename support (#1559)
d7821c3 Upgrade TypeScript and React types (#1572)
1a23d2d Await fixture watcher cleanup (#1571)
7d0c249 Await dev server plugin callback and refactor tests (#1570)
69b7640 Replace delay dependency with setTimeout (#1569)
dcc328e Upgrade to Prettier v3 (#1568)
db0339b Fix Corepack env var in PnP CI job (#1567)
8bec88a Improve text flow
9724645 Skip Corepack check in PnP CI job (#1565)
2dc6672 Fix ts-node scripts on Node 20 (#1564)
dd79b2c Disable code blocks in docs search (#1563)
da2b475 Fix website demo (#1562)
90db9bd Fix docs links (#1561)
0da9c6b Docs website (#1542)
5d4f82c Fix Todo App example initial fixture ID (#1557)
b479ec9 Show Array length instead of keys in Control Panel (#1556)
115f43e Increase Yarn network timeout (#1555)
abd71bd Normalize Vite index path (#1554)
593608c Improve Next.js docs (#1547)
9be090e Add Next.js sub folder documentation (#1546)
025e7c1 Upgrade dependencies (#1543)
569e1cd Support relative vite.indexPath (#1540)
5d9b4be Improve secure WebSocket code (#1539)
3824c75 Support secure websocket connections (#1537)
e8e7b16 Black badges (#1538)
e162ccb Optimize index.html by caching fixture list on server (#1536)
6c226a3 Clean up server plugins (#1535)
a2af21a Update fixture list in index.html on page refresh (#1533)
f88e4e6 MDX support (#1531)
33698af Enable fullscreen permission on RendererPreview iframe (#1530)
0755897 Don't show panels on mobile by default (#1528)
f02f4c0 Document Lazy mode (#1527)
285c677 Document Cosmos UI (#1526)
5e40409 Document architecture goals (#1524)
1e1976b Fix demo link
b08bac4 Document key features (#1523)
a897ae4 Add initial fixture ID option (#1522)
1d09217 Add TodoMVC example (#1521)
ae60c82 Add docs on how to publish plugins (#1520)
9b65416 Document UI plugins (#1519)
2b1eb48 Document CLI and plugin APIs (#1518)
f442f14 Show config options using tables in docs (#1517)
4755b0c Mention omit option (#1515)
f26189c Improve getting started guides (#1514)
087a590 Fix Next.js docs link
99753c9 Make Discord badge more obvious
6d0294c Organize docs (#1510)
769ff8b Add support for TS Vite config (#1512)
ccc39a5 Publish CJS server mocks (#1508)
057fb98 Make getFixtures API compatible with Jest (#1507)
3619136 Convert getFixtures() API work with ESM (#1506)
3207612 Refactor getFixtures() API (#1505)
71432ef Move Jest ESM mocks to config from individual tests (#1504)
52c136d Update Next.js docs (#1502)
d9fdd1a Don't create new history entries in Next.js renderer iframe (#1503)
ca69d1c Fix navigation in Next.js static exports (#1501)
467e7b4 Generate imports module when exporting (#1500)
a3c2250 Don't reset fixture state when re-selecting fixture (#1499)
fdbaa56 Add Next.js static export support (#1498)
4facf3c Simplify RendererConfig type (#1496)
739eecd Expose custom renderer URL (#1495)
2134bc7 Clean up CRA Fast Refresh hack from cosmos command (#1494)
1a746fc Revert "Embed rendererUrl in Renderer config (#1493)"
6c73f53 Embed rendererUrl in Renderer config (#1493)
54d4d96 Add support for dynamic renderer URL (#1492)
86644b2 Redesign renderer URL (#1491)
6ba9f2d Increase test helper timeout
5eb4a31 Extract SelectedFixture type outside of Client code
8118727 Decouple renderer context from search params (#1490)
3dbaa6d Simplify Next.js integration (#1489)
9bbd672 Add logos to website (#1488)
25cf89a Update config JSON schema
b87d3fe Update responsive preview devices (#1487)
2cf8bd0 Next.js App Router docs (#1486)
4555d71 Decouple renderer/playground params from URL query string (#1485)
046251b Don’t allow renderer to select Playground fixture (#1484)
d6222b6 Remove old Next.js docs
e5e1292 Add 'use client' directive to DelayRender component (#1483)
942e357 Create react-cosmos/client entry for fixture hooks and decorators (#1482)
ab59b01 Delay renderer blank state for best cross env experience (#1481)
468110c Fix fixture reload in server fixture loader (#1480)
151523c Make useSelect resilient to infinite render loops (#1479)
95935ad Don't change selected renderer fixture on connect (#1478)
1507195 Delay fixture tree blank state (#1477)
04683cb Add Next.js renderer package (#1476)
76ca48b Improve React Native renderer experience (#1475)
3afe6dd Make fixture list updates more resilient in lazy mode (#1474)
660d495 Add fixture routing for server-side renderer (#1473)
6e6c00e Restore PNP test workflow (#1472)
79b931d Make fixture loader compatible with React Server Components (#1471)
39289ae Fix loading DOM renderer in Vite plugin (#1470)
0f348ba Export FixtureCapture component (#1469)
0c69a37 Simplify log message
d38bc96 Clean up imports (#1467)
f4229fa Remove extensions from TypeScript imports (#1466)
f8a9e85 Generate TypeScript imports module (#1465)
41a6563 Fix fixture search bug (#1464)
723758e Prettify
fe0c7d1 Fix remote renderer overlay (#1463)
b216096 Improve React Native experience (#1462)
04f1bc7 Improve Next.js compatibility (#1461)
6c723c1 Upgrade dependencies (#1460)
aca912b Fix import path
2586b82 Add Vite plugin customization (#1459)
da91267 Add support for user Vite config (#1458)
e154f9a Improve React Native guide (#1456)
00f2473 Match multi fixture by path only until fixture names are available (#1455)
9e66686 Extract separate React Native guide (#1454)
a7a7dfc Improve entry point detection in Vite plugin (#1453)
eeec389 Embed fixtures in playground (#1449)
799e71f Fix flag for generating userdeps (#1450)
49993aa Update CRA config example
0efe04d Update webpack bullets in roadmap
6f7532d Pin next releases to exact versions
30a3a45 Split code blocks for easier copy paste (#1448)
0df857c Add custom bundler setup guide (#1447)
b4f1d85 Fix migration guide path
ada5aec Update docs for React Cosmos 6 (#1446)
359eddd Pass Cosmos config updated by plugins to webpack loader (#1445)
0b048af Use exact dependency versions in canary release (#1444)
03b80da Lazy mode (#1443)
68b6ea0 Fix typo
69fd664 Clean up main package file structure (#1442)
0d1dbd5 Redesign server plugins (#1441)
f81ed4d Fix DefinePlugin warning Webpack emits on a fresh install with create-react-app (#1440)
6d1f90a Run test workflows on PRs (#1438)
34f9c32 Increase awareness of the ability to override Webpack config (#1437)
118b8d9 Move DOM config from webpack plugin to core (#1435)
68b9ee4 Install organize imports Prettier plugin (#1434)
6d9c90c Automatically enable webpack top level await (#1433)
c130324 Reduce redundant workflow tests (#1429)
6954268 Replace Slack links with Discord (#1428)
66b02b5 Don't publish canary in commits with tags
68d5238 Add option for ignoring fixture and decorator files (#1427)
712e244 Fix jumping cursor bug in control input (#1426)
6aefc11 Add React Native step to migration guide (#1425)
18bf80a Add migration guide for React Cosmos 6 (#1424)
0f73dbd Update roadmap (#1422)
9f98170 Add Yarn PnP compatibility (#1421)
dffb812 React Cosmos v6 roadmap (#1366)
ac3eae1 Upgrade Codecov (#1418)
5c6e532 Fix URL parsing in NativeFixtureLoader (#1417)
ebeafed Ignore node_modules when detecting local Cosmos plugins (#1416)
36d3be3 Start server before plugins are loaded (#1415)
1dc3b1b Fix website source map warnings (#1414)
c95c368 Fix renderer URL resolving (#1413)
25e13ac Fix canary release workflow
052c9ad Fix canary release branch
e74cb42 Add canary release workflow (#1411)
cfd2b78 Test source and examples concurrently (#1410)
88f992b Migrate CI to GitHub Actions (#1408)
db57153 Vite integration (#1406)
59bae62 Reorganize codebase (#1384)
dd47d32 Upgrade react-element-to-jsx-string dependency to allow react 18 peer dependency (#1394)
435c0b2 Allow copy to clipboard from playground (#1388)
ffbf754 Extract react-cosmos-plugin-open-fixture plugin (#1379)
40c34a0 Merge web and native dev server plugins (#1378)

---

This discussion was created from the release v6.0.0.