React Cosmos Versions Save

Sandbox for developing and testing UI components in isolation

v6.1.1

1 month ago

cb0bcd0e18f400f6bd36cfa7b2478290c3db5e18 Inline React state types to improve Preact compat (#1628)

v6.1.0

1 month ago

A few significant contributions in this release:

  • Improved fixture hooks were consolidated under the Fixture Inputs umbrella. All previous APIs remain backwards compatible.
  • Codebase has moved away from the deprecated Yarn 1.x to latest NPM.
  • Cypress tests were migrated to Playwright, which is incredibly snappy and opens the door to more automation.

Full Change Log

899946ca84182d0e796575ab5397e3ea12431ca2 Make fixture input hooks less generic (#1626) 84a35daf691123ade109b1f11af0cd4d7e689538 Redesign Inputs API (#1619) 5364b02d03f71bb318da044d5d91ec60528f313b Ignore keyboard shortcuts when target is contenteditable (#1625) 2b25174ed0e6f6899a05ca691275146342d3daa2 Remove Yarn (#1622) b3b5414e2da01cd542fadf9312e4d10375f44033 Migrate Cypress tests to Playwright (#1621) 8fe9f6ff15af15a112a8ebd314a221613e2a1dd7 Document how to suppress ESLint fixture warnings (#1618) 2806ea711b679d1f47726cdc1dc48065e7a3c1ee Improve useValue type inference (#1617) 2314a552ecb325a7601415058f5dac67df41fe41 Expose home overlay UI plug (#1616) a484ae093d4843e1ed0366e9871936baad03b1fd Fix select controls to handle groups in reactions (#1516) @max-scopp

v6.0.3

3 months ago

789aaeda093ddab6105b07a214991eb52aad552a Fix stale fixture props when HMR causes a remount (#1614) 42fbd3757f9e4a3563a7cab884797019b46f4bff Select URL fixture param over initial fixture config (#1613) ba5bf840dfe5e39566ccf6f262c36017bf5552d1 Fix Cosmos logo image path 0e81f3e63bcfea85b22d336c8bbed7efa44ab9a8 Fix link in website footer

v6.0.2

3 months ago

5ca1eac7011daecb6a71a266ca973fdf6e25efc6 Update funding link (#1611) 7d31699e5f2319f1906a738d9a11e853ac0d7ce4 Update FUNDING username 99d0b4593974950567813da120665538ea4c5034 Document number input functionality (#1610) c7d176d948499823a5c1994ac5364b390c090d69 Upgrade GitHub Actions (#1609)

v6.0.1

3 months ago

15ea22982db1f4b7f868c629f679fd5918f33be3 Improve shortcuts and open fixture plugin (#1608) f771e1d50c52b3096ce54466c3799e32c1668052 Add release badge on website (#1607) c474875abe9777efd2f15765bb993fe99bf01752 Remove next dist tag from install instructions (#1604)

v6.0.0

3 months ago

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.

Cosmos

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

Full Change Log

a687430156d020fdecd1a6ec53b10ae43d9892c2 Mark getFixtures API as experimental (#1603) f61f2b67cdad2c362b79c55dae23b84f65e83691 Upgrade dependencies and remove pkg-up (#1602) da8b95ee78d674420b2a52c2dd02380d7244dc82 Improve Community Standards (#1601) 86b9647915f4e0fc03d27f2f89dcfa7668e8fbf1 Fix commit prefix 3cfdcfd6a3d8af620d575b49c6bba72e89f1938a Publish website on release commits (#1600) f128af23e90567fb7193bff913abefd5a5bb2e6f Simplify keyboard shortcuts (#1599) 561b52ae7289e7beb43ffc9216883f817b2c13ed Update app favicon and docs links (#1598) 50fdd7332a6497e4786516cdc11dc958c7eaf6b2 Remove old website (#1597) 55752efb02aed7db1dbbb3d4b03dd0feab13fc2f Add OpenGraph tags to website (#1596) 11ad824fd848da109baee9560804486e930c2cd3 Add .ico favicon and update logo (#1595) 10c9ae9ecc9886484f3a495f713fedef4cbfd8f6 Add link to UI features on homepage (#1594) c86a8ee6650ded55b8acb554e20200a9fd200b9e Add benefits to homepage (#1593) d60c866d3346e82342c8e3edd18551719db4e2c9 Improve docs readability (#1592) c00ca07a5b6a2cad4a218d8aae72fa4c2310cc1e Ignore ts-node warnings (#1591) 01bd836748e8156b0d563013e6119375c463404f Add features to home page (#1590) 17b8ccb504f00467e2adbf6b84e40d1db9e67386 Add architecture docs (#1589) c9d42ed3248aaaee27aaf5ca2c7063012956da8b Add table with config options to docs (#1588) f94afb4435b4ca5be217d39523d49d1cf847985f Prevent auto opening Cosmos renderer in browser (#1587) 595c147b08d9e6210676d9377725e6dfeab9fe3f Add instructions for installing Vite (#1586) c2e10cc5cd8787090f1defd65c6ff3ce8bae12be Improve plugin docs (#1585) 1e61d98c3fd868e19da528b7dce3636c040d8646 Improve fixture modules and useValue docs (#1584) 9af8fcba004c1ae957c2b9e5492f373bb45736ee Add useFixtureState example in docs (#1583) 6d249011a0182697c554735706e3d253b2c728dd Isolate fixture state between plugins (#1581) f5c981ab25d4b15c5ea7b9fb7e2834dc1d623f72 Clean up old TS component return type workaround (#1582) 28d867204eff3744a9731177b6827fa53dcd293e Allow UI plugins to extend initial fixture state (#1579) 2610c0f8ea6c98de7d9f45443fc51903afd1feb0 Fix loading of 3rd party UI plugins (#1578) 50a9804f8db0e91f8ffba8f349ff92cd1f9f69f8 Fix React Native for Web link 0d38d4a70ee83681754db117bc61a54c67e9ffe0 Upgrade dependencies (#1566) 1d2b9f62c09035cde818d163e01edc546a4ebe8c Exclude test helpers from react-cosmos-ui index (#1576) 7332ee114f1b14084724562d49531463c9c12235 Upgrade Lerna 0f025d131fdf2620619cf08b2d50c0de3908528b Don't collapse unnamed fixture on fileDir tree node (#1575) 18af053a674d4d9779fc86c7e5d9d3ac3f2af024 Add fixture filename support (#1559) d7821c3b023a470d9ef9a610ace118a52b8ea29a Upgrade TypeScript and React types (#1572) 1a23d2df70b717e76fb7e7c96a0a089b2990f6f9 Await fixture watcher cleanup (#1571) 7d0c249da9fbea799c3dfd6b38bd0f4e96b59c10 Await dev server plugin callback and refactor tests (#1570) 69b7640d065a1edaa24b4c8f23f678109e1a894a Replace delay dependency with setTimeout (#1569) dcc328eced51c96143e6605ffd3cb01af9303618 Upgrade to Prettier v3 (#1568) db0339bde6a8444149174b9c84fc885ddd0eb93b Fix Corepack env var in PnP CI job (#1567) 8bec88a5fb22c1fbc39ca241d1e4b22b7bf9cdaa Improve text flow 9724645ba492b899ce5f1fe4090121de5a1bf1f0 Skip Corepack check in PnP CI job (#1565) 2dc66726968260fe2d3f864e3aa834aa40f39144 Fix ts-node scripts on Node 20 (#1564) dd79b2ce043ffeb0f5a13ddfbb5ace9d10c40e24 Disable code blocks in docs search (#1563) da2b475a83959603545b1f493628254e9e8b0789 Fix website demo (#1562) 90db9bd91b7b1c6739b804921e8e2398d4841ce5 Fix docs links (#1561) 0da9c6b9a1fffbac5dee0e80e738ada9d5aa7b9b Docs website (#1542) 5d4f82ce3770c2f4ee092cced83f6759e9905309 Fix Todo App example initial fixture ID (#1557) b479ec9cf460be2f6249255c628d30b390b598b4 Show Array length instead of keys in Control Panel (#1556) 115f43ef91b501e2ff9dd89944d4d5efd4d57482 Increase Yarn network timeout (#1555) abd71bd5b7ff4bc4d0ed91e49878a351230d9e11 Normalize Vite index path (#1554) 593608c7f857bd43872299edbedb8d4edccc13ad Improve Next.js docs (#1547) 9be090ee3fa9ac8828639c0ebf9294435771e25e Add Next.js sub folder documentation (#1546) 025e7c1ed755313489d117d6f15b2f7d4cc5f237 Upgrade dependencies (#1543) 569e1cdca75ef543e58496f558f3137109bf656a Support relative vite.indexPath (#1540) 5d9b4bea405ea3429c260436c4e5c68eca4f696e Improve secure WebSocket code (#1539) 3824c7551b85e471c774af638f0b6cf64209ba05 Support secure websocket connections (#1537) e8e7b164109882ab6d74122cbdd769a655449fb4 Black badges (#1538) e162ccb97092a1ca9f4247d2884ee8db6152726a Optimize index.html by caching fixture list on server (#1536) 6c226a3f092e410d2cf11c95c4c58d5d41ab6c53 Clean up server plugins (#1535) a2af21ad286ab875c286ebcec759bdd21b1aaf6d Update fixture list in index.html on page refresh (#1533) f88e4e63ec8778aa0185c17aebfd987ed5393525 MDX support (#1531) 33698afa318767db7b7829393f830b0406a300a8 Enable fullscreen permission on RendererPreview iframe (#1530) 0755897983759b7c0062238c6ddf396dc9e1a842 Don't show panels on mobile by default (#1528) f02f4c0176b844de789ade66f50cac3399bc05b6 Document Lazy mode (#1527) 285c677258b718d7169aae5513671d659c2a7d8b Document Cosmos UI (#1526) 5e40409d7363c1adb2b7229e5950ace829f193b3 Document architecture goals (#1524) 1e1976b2a18d56795c5ac018dccd609824e33e78 Fix demo link b08bac408065c6a3bd3587c7fdfbc7a33ec2aa31 Document key features (#1523) a897ae40a5ab1c96edcec2a807dd0aadf2e39814 Add initial fixture ID option (#1522) 1d0921703153604776965021ce0b55d3ffe2b31c Add TodoMVC example (#1521) ae60c82a64007ae9a5483a0724172573f63c333e Add docs on how to publish plugins (#1520) 9b65416a2e8abd5ba3c960adf52ffad83de977fa Document UI plugins (#1519) 2b1eb4811b7f1b9c353519cc1956a36a34fddd5c Document CLI and plugin APIs (#1518) f442f14ad68600be918faaecaeba61d51e2fb074 Show config options using tables in docs (#1517) 4755b0c11502cda9b0347b5a04c1838896815e77 Mention omit option (#1515) f26189c113b0ed8565f8ac2f5679b507dc5d02a2 Improve getting started guides (#1514) 087a590d5e9d6803b2592c13dd364c19c146efd0 Fix Next.js docs link 99753c95bf9058b65ce968bf56a93e6adca491a1 Make Discord badge more obvious 6d0294c2a134e1672591c0bcd78fbf278408610a Organize docs (#1510) 769ff8b7a745b7b1fe26fd0fd7500be5e772ba8e Add support for TS Vite config (#1512) ccc39a576392d9967fef0723e3e27241d1715f12 Publish CJS server mocks (#1508) 057fb9824f2ee54a41c27eaa13ee9b4c18ed87b6 Make getFixtures API compatible with Jest (#1507) 36191361bc23e8cb4d347879d8f074bc238e7cd8 Convert getFixtures() API work with ESM (#1506) 32076126456a1761da17dbe27b8d90f7e06f5f71 Refactor getFixtures() API (#1505) 71432ef9d81afa1cecc1528fd050e68a581fd471 Move Jest ESM mocks to config from individual tests (#1504) 52c136df569094696ead14c2c5106b13f686f3b1 Update Next.js docs (#1502) d9fdd1a7d55c9fd65044e5c31afc4bdce4c89707 Don't create new history entries in Next.js renderer iframe (#1503) ca69d1c056ade5805741145cc687e6becedda272 Fix navigation in Next.js static exports (#1501) 467e7b4a7d57f4843adaf41b15ba5d6b15c0cb52 Generate imports module when exporting (#1500) a3c22500ea2d1e79d138da633c4f9a370608ac61 Don't reset fixture state when re-selecting fixture (#1499) fdbaa565382e2685f7ac21aecec25f2d78c7b8ab Add Next.js static export support (#1498) 4facf3cc1217c917bdb7d90fa7d7a72d8374d197 Simplify RendererConfig type (#1496) 739eecd772ae1e481cab2eca6090de2837739d64 Expose custom renderer URL (#1495) 2134bc79e976a27add452e85eee35b4b4ae493a4 Clean up CRA Fast Refresh hack from cosmos command (#1494) 1a746fc084fd7cb2a538ed2e70672827cca2b30a Revert "Embed rendererUrl in Renderer config (#1493)" 6c73f5344a9d1a60ac789a3a718a51b4121589e7 Embed rendererUrl in Renderer config (#1493) 54d4d9647224c3809846066661046acd755059a7 Add support for dynamic renderer URL (#1492) 86644b27e838006a0b58c8e917fa1b10e92c956b Redesign renderer URL (#1491) 6ba9f2dfaa73c5c9f69a4e732a44f6dbcc918a70 Increase test helper timeout 5eb4a318eae7adcc1d8cc75b7590d2b433546205 Extract SelectedFixture type outside of Client code 81187278dc56f44029e070ea67e2acddf3293282 Decouple renderer context from search params (#1490) 3dbaa6d662bef15573cabf44e7a4d811a3773d22 Simplify Next.js integration (#1489) 9bbd672cd6bd6c2955c8d7c527c6ef1e48d1684f Add logos to website (#1488) 25cf89a4a1308562d1ba6d72d27b75050a60755e Update config JSON schema b87d3fe06a56c8e3c4c87e731e31092df67d52c0 Update responsive preview devices (#1487) 2cf8bd0439299cd1a57d59d4b03fff4b62fc7acf Next.js App Router docs (#1486) 4555d71dd56acebc908db2d0dec2884c4cdbe902 Decouple renderer/playground params from URL query string (#1485) 046251ba11ee5e090e0974fe0192fcd3b5ea9912 Don’t allow renderer to select Playground fixture (#1484) d6222b6e5660836a633f76348bbe812b0f0a736e Remove old Next.js docs e5e1292597e81fa768848c8ee4dc8aa8ed35f12e Add 'use client' directive to DelayRender component (#1483) 942e357c7e12dcca8f513a87501cb4ff775372ce Create react-cosmos/client entry for fixture hooks and decorators (#1482) ab59b011ccf0b9e1f6969e3aed3e45228836bee8 Delay renderer blank state for best cross env experience (#1481) 468110c1f59ef6c3b3c7ccad777330cc003991f9 Fix fixture reload in server fixture loader (#1480) 151523cc4fd20b3ccf0287336a75c89997b622c4 Make useSelect resilient to infinite render loops (#1479) 95935ad289b68fa1cf889feb98b90beb69931ad3 Don't change selected renderer fixture on connect (#1478) 150719572ee7a2b8da6db654ffc5e8018ebaefc0 Delay fixture tree blank state (#1477) 04683cb3f17b7b8d437e0a26c8a094e84649e727 Add Next.js renderer package (#1476) 76ca48bb9aba923beba088acbe063d1ae5bd3a02 Improve React Native renderer experience (#1475) 3afe6ddef9490e34f6b8151100800473f3ea2c29 Make fixture list updates more resilient in lazy mode (#1474) 660d49529dd6f84ecd5a7d093ac9358ec46d99f2 Add fixture routing for server-side renderer (#1473) 6e6c00e973fc0d0ef43e1851492e93b554fd1baa Restore PNP test workflow (#1472) 79b931da2a86e2599d2aaa37820c275f4e8ecb69 Make fixture loader compatible with React Server Components (#1471) 39289ae2de275ec6fd66f9c4b26e84627bd66d15 Fix loading DOM renderer in Vite plugin (#1470) 0f348ba1f0f9cde9afb561f678bbd74828c72f9f Export FixtureCapture component (#1469) 0c69a3799c6542ff1912c0b651daceae8e7e06f4 Simplify log message d38bc96427cf10b7cf41ca8208201cb4086ea8fd Clean up imports (#1467) f4229fad6cea3dbd68e48e4914d43261dedac85c Remove extensions from TypeScript imports (#1466) f8a9e8562ab28d107caaed31235cc6e359365fff Generate TypeScript imports module (#1465) 41a65634c59681f1b0d91a903fa0b2dcf227d3d9 Fix fixture search bug (#1464) 723758e3dcb8aa97df8c90850e5f1942cb6fb111 Prettify fe0c7d1b5b90f48d6109bc18a2750ab2a347d016 Fix remote renderer overlay (#1463) b2160960f71f4011c0bdbf6acd4465b7d5ad00f2 Improve React Native experience (#1462) 04f1bc71515d87ca6b7069f4c06db1e861f7698a Improve Next.js compatibility (#1461) 6c723c15ffd59c258aff4381ca4166d15eef7ce8 Upgrade dependencies (#1460) aca912b4cc4430cdd604ed2f78ea9d261ee0da64 Fix import path 2586b825f3326004859e3307fc3744748d431b1d Add Vite plugin customization (#1459) da912672c3937782c6c7b97b42cf40aafaa907c8 Add support for user Vite config (#1458) e154f9a0e11cf2666d3da277b30278c4c711e6b9 Improve React Native guide (#1456) 00f24737ae15e5923c336c97b9838bec471c3bda Match multi fixture by path only until fixture names are available (#1455) 9e66686ea2b77cc217c46fabc9192e3e86193a61 Extract separate React Native guide (#1454) a7a7dfc3b5e4f396f4bd5fa5f0fc418ecd341e56 Improve entry point detection in Vite plugin (#1453) eeec389b1ccfee3a773628a7bf0795c893b00903 Embed fixtures in playground (#1449) 799e71f310cc92863a5337702f97b5f79d33d453 Fix flag for generating userdeps (#1450) 49993aa570aadce0e4a689c40493d8f65c908a9b Update CRA config example 0efe04dcbd338ece72d32300165ee39c82e2755b Update webpack bullets in roadmap 6f7532d89534db7898bbea8586ab89d0516c9140 Pin next releases to exact versions 30a3a458402acd9f455d76dc8d5c5af9af0fa542 Split code blocks for easier copy paste (#1448) 0df857c442104377bce8aa16cc81202505cc95b1 Add custom bundler setup guide (#1447) b4f1d85577cc5bac2f493ea1a33aa40d64321f3f Fix migration guide path ada5aec5d92c3602f6c7ab2c0f3869b968b334e5 Update docs for React Cosmos 6 (#1446) 359eddd664ff9f6de285c7efe3684ef60dbe2bcc Pass Cosmos config updated by plugins to webpack loader (#1445) 0b048af65a4a302d42c6f62d94ef7470706fa85b Use exact dependency versions in canary release (#1444) 03b80da1b8741a929868d74771832dde14fcba2b Lazy mode (#1443) 68b6ea05ab44bf9ad88f5b16a9872fba58d9a4fa Fix typo 69fd664fc093ab08df5ebd980a0ace4ebd233dd2 Clean up main package file structure (#1442) 0d1dbd57a7e2e495a9a60741b3908c353482fcf7 Redesign server plugins (#1441) f81ed4d853c135837ec92a325dacdc321b8b7802 Fix DefinePlugin warning Webpack emits on a fresh install with create-react-app (#1440) 6d1f90adb0d5ca8ca8c9794bc8264671dc91abeb Run test workflows on PRs (#1438) 34f9c3253612c6e9d1b45f77d0dbc8c22f618bab Increase awareness of the ability to override Webpack config (#1437) 118b8d92996abb4ec43f6fe7db22eb6c1e1ccfbc Move DOM config from webpack plugin to core (#1435) 68b9ee4b7dec78ca6136588c47d49dea25fe5460 Install organize imports Prettier plugin (#1434) 6d9c90c0d4eed8f2dd73759bfd64547e4fdbfac0 Automatically enable webpack top level await (#1433) c13032495a55eb60f683481a3bd54f76a91239a9 Reduce redundant workflow tests (#1429) 69542683b77cfacc3adaa70ac2f7716bbb34c443 Replace Slack links with Discord (#1428) 66b02b51e34e93bd81afcb7af36209d8813c0769 Don't publish canary in commits with tags 68d5238f990ea73cb3080b5b6000e964c7b7c5a6 Add option for ignoring fixture and decorator files (#1427) 712e2440417e5c7e690fe0b31715411acc67fd82 Fix jumping cursor bug in control input (#1426) 6aefc11752c44ad442dfeccd47858f59aa7cf605 Add React Native step to migration guide (#1425) 18bf80a724fd16389ff29324181487cb58712f3b Add migration guide for React Cosmos 6 (#1424) 0f73dbdeff46d2ddf4d85da71fdb41ea4df7322e Update roadmap (#1422) 9f98170867488dfaa8166907a0c6557ef8308e1f Add Yarn PnP compatibility (#1421) dffb812d8937984365421b94d62325c076659eba React Cosmos v6 roadmap (#1366) ac3eae1bf11f7ebd88b485e2bd04275f83ab2816 Upgrade Codecov (#1418) 5c6e532cb3b5daa901b02e09a7bf66ec06719da0 Fix URL parsing in NativeFixtureLoader (#1417) ebeafed0ae3ec27cfb10008f26b474782f8b0fcc Ignore node_modules when detecting local Cosmos plugins (#1416) 36d3be391b4a5b30062094b64842ab84c5c8f3f0 Start server before plugins are loaded (#1415) 1dc3b1b21c10e66337a35847f1e4578a41bbef3a Fix website source map warnings (#1414) c95c3682cabbf60c55eb37ce5ba8d60311feec45 Fix renderer URL resolving (#1413) 25e13ac0b159de822d9203c7fedf9d0c40634de5 Fix canary release workflow 052c9adeadea308186aa744eda06a6d402a9499c Fix canary release branch e74cb4216417992acb1f880fe9f0492e6c3dce3e Add canary release workflow (#1411) cfd2b784b0c26518134ba22b80b2ed0a838d95f1 Test source and examples concurrently (#1410) 88f992bbcbf954fd8b4b672362efd0d50fcb9885 Migrate CI to GitHub Actions (#1408) db571536411cc517ed59e1e8f08747f7b1a89608 Vite integration (#1406) 59bae6261505c6a13252808bf9fa9e8cf140b2c9 Reorganize codebase (#1384) dd47d323011d346d46917c0d4ba7e56e20018d47 Upgrade react-element-to-jsx-string dependency to allow react 18 peer dependency (#1394) 435c0b2be70fa756237d3bccdf8c0b205bf501bc Allow copy to clipboard from playground (#1388) ffbf754053a794fdd58112f389d8995ec4e51a91 Extract react-cosmos-plugin-open-fixture plugin (#1379) 40c34a0427e3a50dc772bd1ff915073ddd074e1c Merge web and native dev server plugins (#1378)

v5.7.2

2 years ago

392a4539 Select initial fixture from remote renderers (#1376)

v5.7.1

2 years ago

7c9e1e8a Redesign initial fixture option (#1375) 251e76c5 Revert "Add Cloudflare tag"

v5.7.0

2 years ago

0e0bd227 Add initial selected fixture props to NativeFixtureLoader (#1374) d3f8e496 Clean up server-side file structure (#1370)

v5.6.8

2 years ago

1578ed6d Fix webpack return type 6bcff47a Automatically remove ModuleScopePlugin from webpack config (#1369) 17f245c0 Refactor internal fixture primitives (#1368) cf6efbd3 Add Cloudflare tag