remix-project mirror
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
David Disu 0845d5fa0f
Merge pull request #1504 from rorye/allow-url-language-selection
2 days ago
.circleci normal assets call 2 months ago
.github/workflows rm action 2 months ago
apps Merge branch 'master' into allow-url-language-selection 2 days ago
libs Merge branch 'master' into allow-url-language-selection 2 days ago
.editorconfig initial commit 2 years ago
.env Setup build and serve commands 1 year ago
.eslintrc Use old eslint config 2 weeks ago
.eslintrc.json Use old eslint config 2 weeks ago
.gitignore par api test 2 months ago
.prettierignore initial commit 2 years ago
.prettierrc initial commit 2 years ago files moved and removed 2 years ago
Dockerfile Copy docker files/config to root directory 2 years ago Copy docker files/config to root directory 2 years ago
LICENSE files moved and removed 2 years ago Update 1 month ago Create (PR automation) (#760) 1 year ago
babel.config.js fix production build 2 months ago
build.yaml Copy docker files/config to root directory 2 years ago
docker-compose.yaml Copy docker files/config to root directory 2 years ago
gulpfile.js publish remix libs 1 year ago
jest.config.js fix jest mapping 4 months ago
lerna.json bump libs versions 12 months ago
nodemon.json Added nodemon for auto-building e2e tests 12 months ago
nx.json perms dialog 2 weeks ago
package-lock.json rm changes in packeage_lock.json 6 days ago
package.json update plugin 2 weeks ago Update 1 month ago Update 6 months ago Fixing broken doco links as mentioned in #1479 5 months ago
tsconfig.base.json perms dialog 2 weeks ago
tsconfig.json remove inadvertent installs in package.json 1 month ago
tslint.json Debugger Iframe plugin (#745) 1 year ago
workspace.json fix tests 2 weeks ago

CircleCI Documentation Status contributions welcome GitHub contributors Awesome Remix GitHub Join the chat at Twitter Follow

Remix Project

Remix Project is a platform for development tools that use a plugin architecture. It encompasses sub-projects including Remix Plugin Engine, Remix Libraries, and of course Remix IDE.

Remix IDE is an open source web and desktop application. It fosters a fast development cycle and has a rich set of plugins with intuitive GUIs. Remix is used for the entire journey of contract development with Solidity language as well as a playground for learning and teaching Ethereum.

Start developing using Remix on browser, visit:

For desktop version, see releases:

Remix screenshot

👉 Remix libraries work as a core of native plugins of Remix IDE. Read more about libraries here

Offline Usage

The gh-pages branch of remix-live always has the latest stable build of Remix. It contains a ZIP file with the entire build. Download it to use offline.

Note: It contains the latest supported version of Solidity available at the time of the packaging. Other compiler versions can be used online only.


  • Install NPM and Node.js. See Guide
    Supported versions:
"engines": {
    "node": "^14.17.6",
    "npm": "^6.14.15"
  • Install Nx CLI globally to enable running nx executable commands.
npm install -g @nrwl/cli
  • Clone the github repository (wget need to be installed first):
git clone
  • Build remix-project:
cd remix-project
npm install
npm run build:libs // Build remix libs
nx build
nx serve

Open in your browser to load Remix IDE locally.

Go to your text editor and start developing. Browser will automatically refresh when files are saved.

Production Build

To generate react production builds for remix-project.

npm run build:production

Build can be found in remix-project/dist/apps/remix-ide directory.

npm run serve:production

Production build will be served by default to http://localhost:8080/ or



Run with docker

If you want to run latest changes that are merged into master branch then run:

docker pull remixproject/remix-ide:latest
docker run -p 8080:80 remixproject/remix-ide:latest

If you want to run latest remix-live release run.

docker pull remixproject/remix-ide:remix_live
docker run -p 8080:80 remixproject/remix-ide:remix_live

Run with docker-compose:

To run locally without building you only need docker-compose.yaml file and you can run:

docker-compose pull
docker-compose up -d

Then go to http://localhost:8080 and you can use you Remix instance.

To fetch docker-compose file without cloning this repo run:

curl > docker-compose.yaml


If you have trouble building the project, make sure that you have the correct version of node, npm and nvm. Also ensure Nx CLI is installed globally.


node --version
npm --version
nvm --version

In 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.

Unit Testing

Run the unit tests using library name like: nx test <project-name>

For example, to run unit tests of remix-analyzer, use nx test remix-analyzer

Browser Testing

To run the Selenium tests via Nightwatch:

  • Install Selenium for first time: npm run selenium-install

  • Run a selenium server: npm run selenium

  • Build & Serve Remix: nx serve

  • Run all the end-to-end tests:

    for Firefox: npm run nightwatch_local_firefox, or

    for Google Chrome: npm run nightwatch_local_chrome

  • Run a specific test case instead, use one of following commands:

     - npm run nightwatch_local_ballot
     - npm run nightwatch_local_usingWorker
     - npm run nightwatch_local_libraryDeployment
     - npm run nightwatch_local_solidityImport
     - npm run nightwatch_local_recorder
     - npm run nightwatch_local_transactionExecution
     - npm run nightwatch_local_staticAnalysis
     - npm run nightwatch_local_signingMessage
     - npm run nightwatch_local_specialFunctions
     - npm run nightwatch_local_solidityUnitTests
     - npm run nightwatch_local_remixd # remixd needs to be run
     - npm run nightwatch_local_terminal
     - npm run nightwatch_local_gist
     - npm run nightwatch_local_workspace
     - npm run nightwatch_local_defaultLayout
     - npm run nightwatch_local_pluginManager
     - npm run nightwatch_local_publishContract
     - npm run nightwatch_local_generalSettings
     - npm run nightwatch_local_fileExplorer
     - npm run nightwatch_local_debugger
     - npm run nightwatch_local_editor
     - npm run nightwatch_local_compiler
     - npm run nightwatch_local_txListener
     - npm run nightwatch_local_fileManager
     - npm run nightwatch_local_runAndDeploy


  • The ballot tests suite requires to run ganache-cli locally.

  • The remixd tests suite requires to run remixd locally.

  • The gist tests suite requires specifying a github access token in .env file.

    gist_token = <token> // token should have permission to create a gist