{"id":15284320,"url":"https://github.com/vidundergunder/storyless","last_synced_at":"2025-07-30T08:11:27.628Z","repository":{"id":207015762,"uuid":"717112259","full_name":"VidunderGunder/storyless","owner":"VidunderGunder","description":"When Storybook is too much. UI DevTools and utilities for fast and enjoyable development.","archived":false,"fork":false,"pushed_at":"2024-09-17T17:00:43.000Z","size":12612,"stargazers_count":3,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-06-30T19:51:38.537Z","etag":null,"topics":["bun","cli","devtool","devtools","dx","figma","frontend","nextjs","open-source","react","storybook","svg","sync","turborepo","typescript","ui"],"latest_commit_sha":null,"homepage":"https://www.npmjs.com/package/@storyless/react","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/VidunderGunder.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-11-10T15:28:55.000Z","updated_at":"2025-05-08T19:07:18.000Z","dependencies_parsed_at":"2024-09-17T20:44:28.494Z","dependency_job_id":"9a7f48ca-f8e4-49c9-8720-b3569dc595e7","html_url":"https://github.com/VidunderGunder/storyless","commit_stats":null,"previous_names":["vidundergunder/storyless"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/VidunderGunder/storyless","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/VidunderGunder%2Fstoryless","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/VidunderGunder%2Fstoryless/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/VidunderGunder%2Fstoryless/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/VidunderGunder%2Fstoryless/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/VidunderGunder","download_url":"https://codeload.github.com/VidunderGunder/storyless/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/VidunderGunder%2Fstoryless/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":267834811,"owners_count":24151642,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-07-30T02:00:09.044Z","response_time":70,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bun","cli","devtool","devtools","dx","figma","frontend","nextjs","open-source","react","storybook","svg","sync","turborepo","typescript","ui"],"created_at":"2024-09-30T14:53:14.912Z","updated_at":"2025-07-30T08:11:27.587Z","avatar_url":"https://github.com/VidunderGunder.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🐉 Storyless\n\nStoryless is a UI DevTool that lets you build and test components in isolation inside of your app.\n\nFor when design system powerhouses like [Storybook](https://storybook.com/) is just too much.\n\nDirect interoperability with your app and main build tools means hard-to-integrate features like authentication, fetching, state management, themes, etc. will just work when you need them.\n\n**[👉 LIVE DEMO](https://storyless.vercel.app/)**\n\n![Storyless](packages/react-storyless/button.png)\n\n## 🚀 Get Started\n\n### [📖 Storyless (React)](https://github.com/VidunderGunder/storyless/tree/main/packages/react-storyless#readme)\n\nComplimentary tools, on the house:\n\n[🦩 Feasy – Feature Toogles](https://github.com/VidunderGunder/storyless/tree/main/apps/feasy#readme)  \n[🦘 JSON Switcheroo – CLI Tool](https://github.com/VidunderGunder/storyless/tree/main/packages/json-switcheroo#readme)  \n[🥷 Figma to SVG – CLI Tool](https://github.com/VidunderGunder/storyless/tree/main/packages/figma-to-svg#readme)\n\n## 🚀 Get Started (for Contributors)\n\n_Note that all installs may require restarting the terminal – and in some cases a complete reboot – to work properly_\n\nClone this repo to your development environment\n\nInstall [node](https://nodejs.org/en/) `\u003e=20.0.0 \u003c21.0.0`\\*\n\n\u003e \\*Alternatively, you can use [Node Version Manager](https://github.com/nvm-sh/nvm#installing-and-updating) with the included `.nvmrc` file\n\u003e\n\u003e ```sh\n\u003e nvm use\n\u003e ```\n\nInstall [bun](https://bun.sh/) `\u003e=1.0.13`\n\nInstall dependencies:\n\n```sh\nbun i\n```\n\nStart developing:\n\n```sh\nbun dev\n```\n\nUnless you're a veteran, it is _highly recommended_ to read through the [**🤯 Problems During Development?**](https://github.com/VidunderGunder/storyless#-problems-during-development) section before starting development.\n\n## What's inside?\n\nThis Turborepo includes the following packages \u0026 apps:\n\n### Apps and Packages\n\n- 📂 **apps**\n  - 📖 **docs** - _Storyless docs (Next.js)_\n  - 🦩 **feasy** - _Feasy Feature Toggling Service (Next.js)_\n  - ~~🦩 **feasy-api** - _Unused backend prototype for Feasy_~~\n  - ▲ **nextjs-app-router** - _Next.js app (app router) for testing_\n  - ▲ **nextjs-pages-router** - _Next.js app (pages router) for testing_\n- 📂 **packages**\n  - 📖 **react-storyless** - _React (and Next.js) library for Storyless_\n  - 🦩 **feasy-drizzle** - _Library to do Feasy Database operations_\n  - 🥷 **figma-to-svg** - _CLI tool to convert Figma designs to SVGs_\n  - 🎨 **ui** - _Shared UI components for the monorepo_\n  - 🧙‍♂️ **scripts** - _Monorepo scripts_\n  - 🧙‍♂️ **tsconfig** - _Reusable TypeScript configurations_\n  - 🧙‍♂️ **eslint-config-storyless** - _Reusable ESLint configurations_\n\n## 📦 Publish\n\n_Note: You need to be a member of the `@storyless` npm organization to publish packages_\n\n```bash\nnpm login\nbun publish-packages\n```\n\n## Useful TurboRepo Links\n\nLearn more about the power of Turborepo:\n\n- [Tasks](https://turbo.build/repo/docs/core-concepts/monorepos/running-tasks)\n- [Caching](https://turbo.build/repo/docs/core-concepts/caching)\n- [Remote Caching](https://turbo.build/repo/docs/core-concepts/remote-caching)\n- [Filtering](https://turbo.build/repo/docs/core-concepts/monorepos/filtering)\n- [Configuration Options](https://turbo.build/repo/docs/reference/configuration)\n- [CLI Usage](https://turbo.build/repo/docs/reference/command-line-reference)\n\n## 🤯 Problems During Development?\n\nBelow are ways to solve them.\n\nAs of now we only support VSCode running on MacOS, Linux and WSL.\n\nYou are free to use anything else, but we can't guarantee that it will work.  \nPlease document your findings if you try something else \u003c3\n\n### Generally\n\nRestart your IDE (VSCode) and/or terminal\n\nRestart your computer\n\n### Permission errors when running commands (MacOS/Linux)\n\nPrefix the command with `sudo`, e.g.:\n\n```bash\nsudo whatever you were trying to run\n```\n\n### Pulling changes from the repository\n\nAlways check for and install new dependecies when you pull changes from the repository:\n\n```bash\nbun i\n```\n\n### Wrong version of Node\n\n- Check your version with\n  ```bash\n  node -v\n  ```\n- Install the correct version according to `engines` in `package.json`\n\n### Wrong version of bun\n\nCheck your version with\n\n```bash\nbun -v\n```\n\nInstall the correct version according to `engines` in `package.json`\n\n### Using 32-bit version of Node (Windows)\n\nGetting `error Command failed with exit code 3221225477` or something similar?\n\nCheck if you're using 32-bit Node.js:\n\n```bash\nnode -p \"process.arch\"\n```\n\nIf so, ensure you're running on a 64-bit system, then install the 64-bit version instead.\n\n### Divergent git branches\n\n```bash\ngit config pull.rebase false\n```\n\n### Ports already in use\n\nKill the processes running on relevant ports:\n\n```bash\nbun run killports\n```\n\n### Weird TypeScript or ESLint errors\n\nFirst, make sure you're running the workspace version of TypeScript and ESLint:\n\nOpen up any TypeScript file in the project and press...\n\n\u003cul\u003e\n  \u003cli\u003e\n    \u003ckbd\u003e⌘\u003c/kbd\u003e + \u003ckbd\u003eShift\u003c/kbd\u003e + \u003ckbd\u003eP\u003c/kbd\u003e on Mac  \n  \u003c/li\u003e\n  \u003cli\u003e\n    \u003ckbd\u003eCtrl\u003c/kbd\u003e + \u003ckbd\u003eShift\u003c/kbd\u003e + \u003ckbd\u003eP\u003c/kbd\u003e on Windows\n  \u003c/li\u003e\n\u003c/ul\u003e\n\nThen ask VSCode to use the workspace TypeScript version:\n\n```\n\u003e TypeScript: Select TypeScript Version\n```\n\nThen restart the TypeScript server:\n\n```\n\u003e TypeScript: Restart TS server\n```\n\nSame for ESLint:\n\n```\n\u003e ESLint: Restart ESLint server\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvidundergunder%2Fstoryless","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvidundergunder%2Fstoryless","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvidundergunder%2Fstoryless/lists"}