{"id":18822123,"url":"https://github.com/paddingme/scratch","last_synced_at":"2026-01-18T13:30:17.562Z","repository":{"id":79873663,"uuid":"187149510","full_name":"paddingme/scratch","owner":"paddingme","description":null,"archived":false,"fork":false,"pushed_at":"2019-05-19T08:35:02.000Z","size":1018815,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":3,"default_branch":"master","last_synced_at":"2024-12-30T03:47:02.143Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/paddingme.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":".github/CONTRIBUTING.md","funding":null,"license":"LICENSE","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":"2019-05-17T05:02:08.000Z","updated_at":"2019-06-13T02:37:27.000Z","dependencies_parsed_at":null,"dependency_job_id":"5a5aa114-1f05-4e06-909a-2399d099cd26","html_url":"https://github.com/paddingme/scratch","commit_stats":null,"previous_names":[],"tags_count":103,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/paddingme%2Fscratch","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/paddingme%2Fscratch/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/paddingme%2Fscratch/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/paddingme%2Fscratch/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/paddingme","download_url":"https://codeload.github.com/paddingme/scratch/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":239758902,"owners_count":19692041,"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","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":[],"created_at":"2024-11-08T00:47:54.178Z","updated_at":"2026-01-18T13:30:17.470Z","avatar_url":"https://github.com/paddingme.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# scratch-gui\n#### Scratch GUI is a set of React components that comprise the interface for creating and running Scratch 3.0 projects\n\n[![Build Status](https://travis-ci.com/LLK/scratch-gui.svg?token=Yfq2ryN1BwaxDME69Lnc\u0026branch=master)](https://travis-ci.com/LLK/scratch-gui)\n[![Greenkeeper badge](https://badges.greenkeeper.io/LLK/scratch-gui.svg)](https://greenkeeper.io/)\n\n## Installation\nThis requires you to have Git and Node.js installed.\n\nIn your own node environment/application:\n```bash\nnpm install https://github.com/LLK/scratch-gui.git\n```\nIf you want to edit/play yourself:\n```bash\ngit clone https://github.com/LLK/scratch-gui.git\ncd scratch-gui\nnpm install\n```\n\n## Getting started\nRunning the project requires Node.js to be installed.\n\n## Running\nOpen a Command Prompt or Terminal in the repository and run:\n```bash\nnpm start\n```\nThen go to [http://localhost:8601/](http://localhost:8601/) - the playground outputs the default GUI component\n\n## Developing alongside other Scratch repositories\n\n### Linking this code to another project's `node_modules/scratch-gui`\n\n#### Configuration\n\nIf you wish to develop scratch-gui alongside other scratch repositories that depend on it, you may wish\nto have the other repositories use your local scratch-gui build instead of fetching the current production\nversion of the scratch-gui that is found by default using `npm install`.\n\nTo do this:\n1. Make sure you have run `npm install` from this (scratch-gui) repository's top level\n2. Make sure you have run `npm install` from the top level of each repository (such as scratch-www) that depends on scratch-gui\n3. From this (scratch-gui) repository's top level, build the `dist` directory by running `BUILD_MODE=dist npm run build`\n4. From this (scratch-gui) repository's top level, establish a link to this repository by running `npm link`\n5. From the top level of each repository that depends on scratch-gui, run `npm link scratch-gui`\n6. Build or run the repositories that depend on scratch-gui\n\nInstead of `BUILD_MODE=dist npm run build` you can also use `BUILD_MODE=dist npm run watch`, however this may be unreliable.\n\n#### Oh no! It didn't work!\n* Follow the recipe above step by step and don't change the order. It is especially important to run npm first because installing after the linking will reset the linking.\n* Make sure the repositories are siblings on your machine's file tree.\n* If you have multiple Terminal tabs or windows open for the different Scratch repositories, make sure to use the same node version in all of them.\n* In the worst case unlink the repositories by running `npm unlink` in both, and start over.\n\n## Testing\n### Documentation\n\nYou may want to review the documentation for [Jest](https://facebook.github.io/jest/docs/en/api.html) and [Enzyme](http://airbnb.io/enzyme/docs/api/) as you write your tests.\n\nSee [jest cli docs](https://facebook.github.io/jest/docs/en/cli.html#content) for more options.\n\n### Running tests\n\n*NOTE: If you're a windows user, please run these scripts in Windows `cmd.exe`  instead of Git Bash/MINGW64.*\n\nBefore running any test, make sure you have run `npm install` from this (scratch-gui) repository's top level.\n\n#### Main testing command\n\nTo run linter, unit tests, build, and integration tests, all at once:\n```bash\nnpm test\n```\n\n#### Running unit tests\n\nTo run unit tests in isolation:\n```bash\nnpm run test:unit\n```\n\nTo run unit tests in watch mode (watches for code changes and continuously runs tests):\n```bash\nnpm run test:unit -- --watch\n```\n\nYou can run a single file of integration tests (in this example, the `button` tests):\n\n```bash\n$(npm bin)/jest --runInBand test/unit/components/button.test.jsx\n```\n\n#### Running integration tests\n\nIntegration tests use a headless browser to manipulate the actual html and javascript that the repo\nproduces. You will not see this activity (though you can hear it when sounds are played!).\n\nNote that integration tests require you to first create a build that can be loaded in a browser:\n\n```bash\nnpm run build\n```\n\nThen, you can run all integration tests:\n\n```bash\nnpm run test:integration\n```\n\nOr, you can run a single file of integration tests (in this example, the `backpack` tests):\n\n```bash\n$(npm bin)/jest --runInBand test/integration/backpack.test.js\n```\n\nIf you want to watch the browser as it runs the test, rather than running headless, use:\n\n```bash\nUSE_HEADLESS=no $(npm bin)/jest --runInBand test/integration/backpack.test.js\n```\n\n## Publishing to GitHub Pages\nYou can publish the GUI to github.io so that others on the Internet can view it.\n[Read the wiki for a step-by-step guide.](https://github.com/LLK/scratch-gui/wiki/Publishing-to-GitHub-Pages)\n\n## Donate\nWe provide [Scratch](https://scratch.mit.edu) free of charge, and want to keep it that way! Please consider making a [donation](https://secure.donationpay.org/scratchfoundation/) to support our continued engineering, design, community, and resource development efforts. Donations of any size are appreciated. Thank you!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpaddingme%2Fscratch","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpaddingme%2Fscratch","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpaddingme%2Fscratch/lists"}