{"id":31199111,"url":"https://github.com/remix-project-org/remix-project","last_synced_at":"2026-04-28T08:04:50.968Z","repository":{"id":37083157,"uuid":"248697283","full_name":"remix-project-org/remix-project","owner":"remix-project-org","description":"Remix is a browser-based compiler and IDE that enables users to build Ethereum contracts with Solidity language and to debug transactions.","archived":false,"fork":false,"pushed_at":"2026-04-27T09:20:12.000Z","size":333272,"stargazers_count":2952,"open_issues_count":847,"forks_count":1342,"subscribers_count":80,"default_branch":"master","last_synced_at":"2026-04-27T11:14:24.355Z","etag":null,"topics":["blockchain","ethereum","evm","hacktoberfest","remix","remix-ide","smart-contracts","solidity","vyper"],"latest_commit_sha":null,"homepage":"https://remix.live","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/remix-project-org.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":"funding.json","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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{}},"created_at":"2020-03-20T07:49:48.000Z","updated_at":"2026-04-27T10:17:24.000Z","dependencies_parsed_at":"2023-10-16T01:17:04.252Z","dependency_job_id":"54062109-157c-43cf-9856-b91114afe1f5","html_url":"https://github.com/remix-project-org/remix-project","commit_stats":{"total_commits":22755,"total_committers":266,"mean_commits":85.54511278195488,"dds":0.6972972972972973,"last_synced_commit":"1425d5b4dfbd31900edc5185567c39a3394fe646"},"previous_names":["remix-project-org/remix-project","ethereum/remix-project"],"tags_count":198,"template":false,"template_full_name":null,"purl":"pkg:github/remix-project-org/remix-project","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/remix-project-org%2Fremix-project","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/remix-project-org%2Fremix-project/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/remix-project-org%2Fremix-project/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/remix-project-org%2Fremix-project/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/remix-project-org","download_url":"https://codeload.github.com/remix-project-org/remix-project/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/remix-project-org%2Fremix-project/sbom","scorecard":{"id":339954,"data":{"date":"2025-08-11","repo":{"name":"github.com/ethereum/remix-project","commit":"99d64392917a88f25987da74e131bd43003292c7"},"scorecard":{"version":"v5.2.1-40-gf6ed084d","commit":"f6ed084d17c9236477efd66e5b258b9d4cc7b389"},"score":4.8,"checks":[{"name":"Maintained","score":10,"reason":"30 commit(s) and 18 issue activity found in the last 90 days -- score normalized to 10","details":null,"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#maintained"}},{"name":"Dangerous-Workflow","score":10,"reason":"no dangerous workflow patterns detected","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#dangerous-workflow"}},{"name":"Code-Review","score":10,"reason":"all changesets reviewed","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#code-review"}},{"name":"Packaging","score":-1,"reason":"packaging workflow not detected","details":["Warn: no GitHub/GitLab publishing workflow detected."],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#packaging"}},{"name":"Token-Permissions","score":0,"reason":"detected GitHub workflow tokens with excessive permissions","details":["Warn: no topLevel permission defined: .github/workflows/autosquash.yml:1","Warn: no topLevel permission defined: .github/workflows/pr-reminder.yml:1","Warn: no topLevel permission defined: .github/workflows/publish-action.yml:1","Warn: no topLevel permission defined: .github/workflows/rebase-pull-requests.yml:1","Warn: no topLevel permission defined: .github/workflows/run-sut.yml:1","Warn: no topLevel permission defined: .github/workflows/service-checker.yml:1","Info: no jobLevel write permissions found"],"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#token-permissions"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#cii-best-practices"}},{"name":"Security-Policy","score":0,"reason":"security policy file not detected","details":["Warn: no security policy file detected","Warn: no security file to analyze","Warn: no security file to analyze","Warn: no security file to analyze"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#security-policy"}},{"name":"License","score":10,"reason":"license file detected","details":["Info: project has a license file: LICENSE:0","Info: FSF or OSI recognized license: Apache License 2.0: LICENSE:0"],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#license"}},{"name":"Binary-Artifacts","score":9,"reason":"binaries present in source code","details":["Warn: binary detected: apps/remixdesktop/circom-download/latest/circom-linux-amd64:1"],"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#binary-artifacts"}},{"name":"Branch-Protection","score":-1,"reason":"internal error: error during branchesHandler.setup: internal error: githubv4.Query: Resource not accessible by integration","details":null,"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#branch-protection"}},{"name":"Signed-Releases","score":-1,"reason":"no releases found","details":null,"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#signed-releases"}},{"name":"Pinned-Dependencies","score":1,"reason":"dependency not pinned by hash detected -- score normalized to 1","details":["Warn: third-party GitHubAction not pinned by hash: .github/workflows/autosquash.yml:25: update your workflow using https://app.stepsecurity.io/secureworkflow/ethereum/remix-project/autosquash.yml/master?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/pr-reminder.yml:15: update your workflow using https://app.stepsecurity.io/secureworkflow/ethereum/remix-project/pr-reminder.yml/master?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/pr-reminder.yml:23: update your workflow using https://app.stepsecurity.io/secureworkflow/ethereum/remix-project/pr-reminder.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/publish-action.yml:11: update your workflow using https://app.stepsecurity.io/secureworkflow/ethereum/remix-project/publish-action.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/publish-action.yml:12: update your workflow using https://app.stepsecurity.io/secureworkflow/ethereum/remix-project/publish-action.yml/master?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/publish-action.yml:20: update your workflow using https://app.stepsecurity.io/secureworkflow/ethereum/remix-project/publish-action.yml/master?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/rebase-pull-requests.yml:11: update your workflow using https://app.stepsecurity.io/secureworkflow/ethereum/remix-project/rebase-pull-requests.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/run-sut.yml:11: update your workflow using https://app.stepsecurity.io/secureworkflow/ethereum/remix-project/run-sut.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/run-sut.yml:13: update your workflow using https://app.stepsecurity.io/secureworkflow/ethereum/remix-project/run-sut.yml/master?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/run-sut.yml:17: update your workflow using https://app.stepsecurity.io/secureworkflow/ethereum/remix-project/run-sut.yml/master?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/service-checker.yml:12: update your workflow using https://app.stepsecurity.io/secureworkflow/ethereum/remix-project/service-checker.yml/master?enable=pin","Warn: containerImage not pinned by hash: Dockerfile:1: pin your Docker image by updating nginx:alpine to nginx:alpine@sha256:5a14017678e59c5310ca52277507c160a3ac5c5c8bdff99891a468beb794f10a","Warn: containerImage not pinned by hash: Dockerfile.dev:2: pin your Docker image by updating node:10 to node:10@sha256:59531d2835edd5161c8f9512f9e095b1836f7a1fcb0ab73e005ec46047384911","Warn: containerImage not pinned by hash: Dockerfile.dev:16: pin your Docker image by updating nginx:alpine to nginx:alpine@sha256:5a14017678e59c5310ca52277507c160a3ac5c5c8bdff99891a468beb794f10a","Warn: containerImage not pinned by hash: apps/remix-ide/Dockerfile:1: pin your Docker image by updating nginx:alpine to nginx:alpine@sha256:5a14017678e59c5310ca52277507c160a3ac5c5c8bdff99891a468beb794f10a","Warn: containerImage not pinned by hash: apps/remix-ide/Dockerfile.dev:2: pin your Docker image by updating node:10 to node:10@sha256:59531d2835edd5161c8f9512f9e095b1836f7a1fcb0ab73e005ec46047384911","Warn: containerImage not pinned by hash: apps/remix-ide/Dockerfile.dev:16: pin your Docker image by updating nginx:alpine to nginx:alpine@sha256:5a14017678e59c5310ca52277507c160a3ac5c5c8bdff99891a468beb794f10a","Info:   0 out of   4 GitHub-owned GitHubAction dependencies pinned","Info:   0 out of   7 third-party GitHubAction dependencies pinned","Info:   0 out of   6 containerImage dependencies pinned","Info:   2 out of   2 npmCommand dependencies pinned"],"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#pinned-dependencies"}},{"name":"SAST","score":0,"reason":"SAST tool is not run on all commits -- score normalized to 0","details":["Warn: 0 commits out of 30 are checked with a SAST tool"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#sast"}},{"name":"Fuzzing","score":0,"reason":"project is not fuzzed","details":["Warn: no fuzzer integrations found"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#fuzzing"}},{"name":"Vulnerabilities","score":0,"reason":"98 existing vulnerabilities detected","details":["Warn: Project is vulnerable to: GHSA-pxg6-pf52-xh8x","Warn: Project is vulnerable to: GHSA-rhx6-c78j-4q9w","Warn: Project is vulnerable to: GHSA-m6fv-jmcg-4jfg","Warn: Project is vulnerable to: GHSA-8hc4-vh64-cxmj","Warn: Project is vulnerable to: GHSA-jr5f-v2jv-69x6","Warn: Project is vulnerable to: GHSA-v6h2-p8h4-qcjw","Warn: Project is vulnerable to: GHSA-grv7-fg5c-xmjg","Warn: Project is vulnerable to: GHSA-ghr5-ch3p-vcr6","Warn: Project is vulnerable to: GHSA-fjxv-7rqg-78g4","Warn: Project is vulnerable to: GHSA-4q6p-r6v2-jvc5","Warn: Project is vulnerable to: GHSA-pfrx-2q88-qq97","Warn: Project is vulnerable to: GHSA-952p-6rrq-rcjv","Warn: Project is vulnerable to: GHSA-mwcw-c2x4-8c55","Warn: Project is vulnerable to: GHSA-584q-6j8j-r5pm","Warn: Project is vulnerable to: GHSA-c2qf-rxjj-qqgw","Warn: Project is vulnerable to: GHSA-76p7-773f-r4q5","Warn: Project is vulnerable to: GHSA-52f5-9888-hmc6","Warn: Project is vulnerable to: GHSA-3h5v-q93c-6h6q","Warn: Project is vulnerable to: GHSA-h5c3-5r3r-rr8q","Warn: Project is vulnerable to: GHSA-wf5p-g6vw-rhxx","Warn: Project is vulnerable to: GHSA-xq7p-g2vc-g82p","Warn: Project is vulnerable to: GHSA-434g-2637-qmqr","Warn: Project is vulnerable to: GHSA-49q7-c7j4-3p7m","Warn: Project is vulnerable to: GHSA-977x-g7h5-7qgw","Warn: Project is vulnerable to: GHSA-f7q4-pwc6-w24p","Warn: Project is vulnerable to: GHSA-fc9h-whq2-v747","Warn: Project is vulnerable to: GHSA-vjh7-7g9h-fjfh","Warn: Project is vulnerable to: GHSA-67mh-4wv8-2f99","Warn: Project is vulnerable to: GHSA-h7cp-r72f-jxh6","Warn: Project is vulnerable to: GHSA-v62p-rq8g-8h59","Warn: Project is vulnerable to: GHSA-p8p7-x288-28g6","Warn: Project is vulnerable to: GHSA-f5x3-32g6-xq36","Warn: Project is vulnerable to: GHSA-8cj5-5rvv-wf4v","Warn: Project is vulnerable to: GHSA-72xf-g2v4-qvf3","Warn: Project is vulnerable to: GHSA-968p-4wvh-cqc8","Warn: Project is vulnerable to: GHSA-rmvr-2pp2-xj38","Warn: Project is vulnerable to: GHSA-xx4v-prfh-6cgc","Warn: Project is vulnerable to: GHSA-v88g-cgmw-v5xw","Warn: Project is vulnerable to: GHSA-93q8-gq69-wqmw","Warn: Project is vulnerable to: GHSA-67hx-6x53-jw92","Warn: Project is vulnerable to: GHSA-832h-xg76-4gv6","Warn: Project is vulnerable to: GHSA-cwfw-4gq5-mrqx","Warn: Project is vulnerable to: GHSA-g95f-p29q-9xw4","Warn: Project is vulnerable to: GHSA-c6rq-rjc2-86v2","Warn: Project is vulnerable to: GHSA-3xgq-45jj-v275","Warn: Project is vulnerable to: GHSA-hr2v-3952-633q","Warn: Project is vulnerable to: GHSA-ff7x-qrg7-qggm","Warn: Project is vulnerable to: GHSA-qrmc-fj45-qfc2","Warn: Project is vulnerable to: GHSA-xf7w-r453-m56c","Warn: Project is vulnerable to: GHSA-44pw-h2cw-w3vq","Warn: Project is vulnerable to: GHSA-jp4x-w63m-7wgm","Warn: Project is vulnerable to: GHSA-c429-5p7v-vgjp","Warn: Project is vulnerable to: GHSA-43f8-2h32-f4cj","Warn: Project is vulnerable to: GHSA-rc47-6667-2j5j","Warn: Project is vulnerable to: GHSA-qqgx-2p2h-9c37","Warn: Project is vulnerable to: GHSA-78xj-cgh5-2h22","Warn: Project is vulnerable to: GHSA-2p57-rm9w-gvfp","Warn: Project is vulnerable to: GHSA-896r-f27r-55mw","Warn: Project is vulnerable to: GHSA-9c47-m6qq-7p4h","Warn: Project is vulnerable to: GHSA-p6mc-m468-83gw","Warn: Project is vulnerable to: GHSA-35jh-r3h4-6jhm","Warn: Project is vulnerable to: GHSA-5v2h-r2cx-5xgj","Warn: Project is vulnerable to: GHSA-rrrm-qjm4-v8hf","Warn: Project is vulnerable to: GHSA-4xcv-9jjx-gfj3","Warn: Project is vulnerable to: GHSA-f8q6-p94x-37v3","Warn: Project is vulnerable to: GHSA-vh95-rmgr-6w4m","Warn: Project is vulnerable to: GHSA-xvch-5gv4-984h","Warn: Project is vulnerable to: GHSA-qrpm-p2h7-hrv2","Warn: Project is vulnerable to: GHSA-5fw9-fq32-wv5p","Warn: Project is vulnerable to: GHSA-ph34-pc88-72gc","Warn: Project is vulnerable to: GHSA-m6cx-g6qm-p2cx","Warn: Project is vulnerable to: GHSA-x8qc-rrcw-4r46","Warn: Project is vulnerable to: GHSA-4328-8hgf-7wjr","Warn: Project is vulnerable to: GHSA-93f3-23rq-pjfp","Warn: Project is vulnerable to: GHSA-pw54-mh39-w3hc","Warn: Project is vulnerable to: GHSA-xgh6-85xh-479p","Warn: Project is vulnerable to: GHSA-76c9-3jph-rj3q","Warn: Project is vulnerable to: GHSA-hcrg-fc28-fcg5","Warn: Project is vulnerable to: GHSA-q674-xm3x-2926","Warn: Project is vulnerable to: GHSA-3j8f-xvm3-ffx4","Warn: Project is vulnerable to: GHSA-j9fq-vwqv-2fm2","Warn: Project is vulnerable to: GHSA-pqw5-jmp5-px4v","Warn: Project is vulnerable to: GHSA-x7hr-w5r2-h6wg","Warn: Project is vulnerable to: GHSA-hrpp-h998-j3pp","Warn: Project is vulnerable to: GHSA-4rq4-32rv-6wp6","Warn: Project is vulnerable to: GHSA-64g7-mvw6-v9qj","Warn: Project is vulnerable to: GHSA-2m39-62fm-q8r3","Warn: Project is vulnerable to: GHSA-mf6x-7mm4-x2g7","Warn: Project is vulnerable to: GHSA-3jfq-g458-7qm9","Warn: Project is vulnerable to: GHSA-5955-9wpr-37jh","Warn: Project is vulnerable to: GHSA-pq67-2wwv-3xjx","Warn: Project is vulnerable to: GHSA-g7q5-pjjr-gqvp","Warn: Project is vulnerable to: GHSA-w5p7-h5w8-2hfq","Warn: Project is vulnerable to: GHSA-7p7h-4mm5-852v","Warn: Project is vulnerable to: GHSA-4v9v-hfq4-rm2v","Warn: Project is vulnerable to: GHSA-9jgg-88mc-972h","Warn: Project is vulnerable to: GHSA-776f-qx25-q3cc","Warn: Project is vulnerable to: GHSA-p9pc-299p-vxgp"],"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#vulnerabilities"}}]},"last_synced_at":"2025-08-18T05:33:36.262Z","repository_id":37083157,"created_at":"2025-08-18T05:33:36.263Z","updated_at":"2025-08-18T05:33:36.263Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32371702,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-27T20:07:02.737Z","status":"online","status_checked_at":"2026-04-28T02:00:07.250Z","response_time":56,"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":["blockchain","ethereum","evm","hacktoberfest","remix","remix-ide","smart-contracts","solidity","vyper"],"created_at":"2025-09-20T08:02:27.222Z","updated_at":"2026-04-28T08:04:50.925Z","avatar_url":"https://github.com/remix-project-org.png","language":"TypeScript","funding_links":[],"categories":["TypeScript"],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003cimg src=\"./apps/remix-ide/src/assets/img/icon.png\" alt=\"Remix Logo\" width=\"200\"/\u003e\n\u003c/p\u003e\n\u003ch3 align=\"center\"\u003eRemix Project\u003c/h3\u003e\n    \n\u003cdiv align=\"center\"\u003e\n\n\n[![CircleCI](https://img.shields.io/circleci/build/github/remix-project-org/remix-project?logo=circleci)](https://circleci.com/gh/remix-project-org/remix-project)\n[![Documentation Status](https://readthedocs.org/projects/remix-ide/badge/?version=latest)](https://remix-ide.readthedocs.io/en/latest/index.html)\n[![contributions welcome](https://img.shields.io/badge/contributions-welcome-brightgreen.svg?style=flat\u0026logo=github)](https://github.com/remix-project-org/remix-project/blob/master/CONTRIBUTING.md)\n[![GitHub contributors](https://img.shields.io/github/contributors/remix-project-org/remix-project?style=flat\u0026logo=github)](https://github.com/remix-project-org/remix-project/graphs/contributors)\n[![Awesome Remix](https://img.shields.io/badge/Awesome--Remix-resources-green?logo=awesomelists)](https://github.com/remix-project-org/awesome-remix)\n[![GitHub](https://img.shields.io/github/license/remix-project-org/remix-project)](https://github.com/remix-project-org/remix-project/blob/master/LICENSE)\n[![Discord](https://img.shields.io/badge/join-discord-brightgreen.svg?style=flat\u0026logo=discord)](https://discord.gg/MzhfCGstNA)\n[![X Follow](https://img.shields.io/twitter/follow/ethereumremix?style=flat\u0026logo=x\u0026color=green)](https://x.com/ethereumremix)\n\n\u003c/div\u003e\n\n## Remix Project\n\n**Remix Project** is a rich toolset including Remix IDE, a comprehensive smart contract development tool. The Remix Project also includes Remix Plugin Engine and Remix Libraries which are low-level tools for wider use.  \n\n## Remix IDE\n**Remix IDE** is used for the entire journey of contract development by users of any knowledge level. It fosters a fast development cycle and has a rich set of plugins with intuitive GUIs. The IDE comes in 2 flavors and a VSCode extension:\n\n**Remix Online IDE**, see: [https://remix.ethereum.org](https://remix.ethereum.org)\n\n:point_right: Supported browsers: Firefox v100.0.1 \u0026 Chrome v101.0.4951.64. No support for Remix's use on tablets or smartphones or telephones.\n\n**Remix Desktop IDE**, see releases: [https://github.com/remix-project-org/remix-desktop/releases](https://github.com/remix-project-org/remix-desktop/releases)\n\n![Remix screenshot](https://github.com/remix-project-org/remix-project/raw/master/apps/remix-ide/remix-screenshot-400h.png)\n\n\n## Remix libraries \nRemix libraries are essential for Remix IDE's native plugins. Read more about libraries [here](libs/README.md)\n\n## Offline Usage\n\nThe `gh-pages` branch of [remix-live](https://github.com/remix-project-org/remix-live) always has the latest stable build of Remix. It contains a ZIP file with the entire build. Download it to use offline.\n\nNote: It contains the latest supported version of Solidity available at the time of the packaging. Other compiler versions can be used online only.\n\n\n## Setup\n\n* Install **Yarn** and **Node.js**. See [Guide for NodeJs](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm) and [Yarn install](https://classic.yarnpkg.com/lang/en/docs/install)\u003cbr/\u003e\n*Supported versions:*\n```bash\n\"engines\": {\n    \"node\": \"^20.0.0\",\n    \"npm\": \"^6.14.15\"\n  }\n```\n* Install [Nx CLI](https://nx.dev/using-nx/nx-cli) globally to enable running **nx executable commands**.\n```bash\nyarn global add nx\n```\n* Clone the GitHub repository (`wget` need to be installed first):\n\n```bash\ngit clone https://github.com/remix-project-org/remix-project.git\n```\n* Build and Run `remix-project`:\n\n1. Move to project directory: `cd remix-project`\n2. Install dependencies: `yarn install` or simply run `yarn`\n3. Build Remix libraries: `yarn run build:libs`\n4. Build Remix project: `yarn build`\n5. Build and run project server: `yarn serve`. Optionally, run `yarn serve:hot` to enable hot module to reload for frontend updates.\n\nOpen `http://127.0.0.1:8080` in your browser to load Remix IDE locally.\n\nGo to your `text editor` and start developing. The browser will automatically refresh when files are saved.\n\n## Production Build\nTo generate react production builds for remix-project.\n```bash\nyarn run build:production\n```\nBuild can be found in `remix-project/dist/apps/remix-ide` directory.\n\n```bash\nyarn run serve:production\n```\nProduction build will be served by default to `http://localhost:8080/` or `http://127.0.0.1:8080/`\n\n## Nx Cloud caching\n\nThis repo uses Nx Cloud to speed up builds and keep CI deterministic via remote caching.\n\n- Configuration: `nx.json` uses the Nx Cloud runner and reads the token from the `NX_CLOUD_ACCESS_TOKEN` environment variable.\n- CI: CircleCI jobs automatically use `--cloud` when the token is present; for forked PRs (no secrets), they fall back to local-only caching. Build logs are stored under `logs/nx-build.log`.\n- Verifying locally: run the same target twice; the second run should print “Nx read the output from the cache”. Example: `nx run remix-ide:build` and run it again.\n- Insights: View cache analytics and run details at https://nx.app (links appear in Nx output when the token is configured).\n\n## Docker:\n\nPrerequisites: \n* Docker (https://docs.docker.com/desktop/)\n* Docker Compose (https://docs.docker.com/compose/install/)\n\n### Run with docker\n\nIf you want to run the latest changes that are merged into the master branch then run:\n\n```\ndocker pull remixproject/remix-ide:latest\ndocker run -p 8080:80 remixproject/remix-ide:latest\n```\n\nIf you want to run the latest remix-live release run.\n```\ndocker pull remixproject/remix-ide:remix_live\ndocker run -p 8080:80 remixproject/remix-ide:remix_live\n```\n\n### Run with docker-compose:\n\nTo run locally without building you only need docker-compose.yaml file and you can run:\n\n```\ndocker-compose pull\ndocker-compose up -d\n```\n\nThen go to http://localhost:8080 and you can use your Remix instance.\n\nTo fetch the docker-compose file without cloning this repo run:\n```\ncurl https://raw.githubusercontent.com/remix-project-org/remix-project/master/docker-compose.yaml \u003e docker-compose.yaml\n```\n\n### Troubleshooting\n\nIf you have trouble building the project, make sure that you have the correct version of `node`, `npm` and `nvm`. Also, ensure [Nx CLI](https://nx.dev/using-nx/nx-cli) is installed globally.\n\nRun:\n\n```bash\nnode --version\nnpm --version\nnvm --version\n```\n\nIn Debian-based OS such as Ubuntu 14.04LTS, you may need to run `apt-get install build-essential`. After installing `build-essential`, run `npm rebuild`.\n\n## Unit Testing\n\nRun the unit tests using library name like: `nx test \u003cproject-name\u003e`\n\nFor example, to run unit tests of `remix-analyzer`, use `nx test remix-analyzer`\n\n## Browser Testing\n\nTo run the tests via Nightwatch:\n\n - Install webdrivers for the first time: `yarn install_webdriver`\n - Build \u0026 Serve Remix: `yarn serve`\n\n        \n**NOTE:**\n\n- **The `ballot` tests suite** requires running `ganache` locally.\n\n- **The `remixd` tests suite** requires running `remixd` locally.\n\n- **The `gist` tests suite** requires specifying a GitHub access token in **.env file**. \n```\n    gist_token = \u003ctoken\u003e // token should have permission to create a gist\n```\n\nThere is a script to allow selecting the browser and a specific test to run:\n\n```\nyarn run select_test\n```\n\nYou need to have \n\n- selenium running \n\n- the IDE running\n\n- optionally have remixd or ganache running\n\n### Splitting tests with groups\n\nGroups can be used to group tests in a test file together. The advantage is you can avoid running long test files when you want to focus on a specific set of tests within a test file.\n\nThese groups only apply to the test file, not across all test files. So for example group1 in the ballot is not related to a group1 in another test file.\n\nRunning a group only runs the tests marked as belonging to the group + all the tests in the test file that do not have a group tag. This way you can have tests that run for all groups, for example, to perform common actions.\n\nThere is no need to number the groups in a certain order. The number of the group is arbitrary.\n\nA test can have multiple group tags, this means that this test will run in different groups.\n\nYou should write your tests so they can be executed in groups and not depend on other groups.\n\nTo do this you need to:\n\n- Add a group to tag to a test, they are formatted as #group followed by a number: so it becomes #group1, #group220, #group4. Any number will do. You don't have to do it in a specific order. \n\n```\n  'Should generate test file #group1': function (browser: NightwatchBrowser) {\n    browser.waitForElementPresent('*[data-id=\"verticalIconsKindfilePanel\"]')\n```\n\n- add '@disabled': true to the test file you want to split:\n\n```\nmodule.exports = {\n  '@disabled': true,\n  before: function (browser: NightwatchBrowser, done: VoidFunction) {\n    init(browser, done) // , 'http://localhost:8080', false)\n  },\n```\n- change package JSON to locally run all group tests (point to appropriate config file depending on environment):\n\n```\n    \"nightwatch_local_debugger\": \"yarn run build:e2e \u0026\u0026 nightwatch --config dist/apps/remix-ide-e2e/nightwatch-chrome.js dist/apps/remix-ide-e2e/src/tests/debugger_*.spec.js --env=chrome\",\n```\n\n- run the build script to build the test files if you want to run the locally\n\n```\nyarn run build:e2e\n```\n\n### Locally testing group tests\n\nYou can tag any test with a group name, for example, #group10 and easily run the test locally.\n\n- make sure you have nx installed globally\n- group tests are run like any other test, just specify the correct group number\n\n#### method 1\n\nThis script will give you an options menu, just select the test you want\n```\nyarn run select_test\n```\n\n### Run the same (flaky) test across all instances in CircleCI\n\nIn CircleCI all tests are divided across instances to run in parallel. \nYou can also run 1 or more tests simultaneously across all instances.\nThis way the pipeline can easily be restarted to check if a test is flaky.\n\nFor example:\n\n```\n  'Static Analysis run with remixd #group3 #flaky': function (browser) {\n```\n\nNow, the group3 of this test will be executed in firefox and chrome 80 times.\nIf you mark more groups in other tests they will also be executed. \n\n**CONFIGURATION**\n\nIt's important to set a parameter in the .circleci/config.yml, set it to false then the normal tests will run.\nSet it to true to run only tests marked with flaky.\n```\nparameters:\n  run_flaky_tests:\n    type: boolean\n    default: true\n```\n\n## Important Links\n\n- Official website: https://remix.live\n- Official documentation: https://remix-ide.readthedocs.io/en/latest/\n- Curated list of Remix resources: https://github.com/remix-project-org/awesome-remix\n- Substack: https://ethereumremix.substack.com\n- Linkedin: https://www.linkedin.com/company/ethereum-remix\n- X: https://x.com/ethereumremix\n- Join our Discord: https://discord.gg/MzhfCGstNA\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fremix-project-org%2Fremix-project","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fremix-project-org%2Fremix-project","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fremix-project-org%2Fremix-project/lists"}