Browser-Only Solidity IDE and Runtime Environment Mirror Remix is a browser-based compiler and IDE that enables users to build Ethereum contracts with Solidity language and to debug transactions. To try it out, visit https://remix.ethereum.org.
|yann300 4e410a8b7e Merge pull request #2617 from ethereum/gist-e2e-tests||2 hours ago|
|.circleci||8 months ago|
|assets||3 months ago|
|bin||11 months ago|
|ci||3 weeks ago|
|contracts||1 month ago|
|docs||2 weeks ago|
|embark||9 months ago|
|src||2 hours ago|
|test||1 month ago|
|test-browser||1 day ago|
|.babelrc||8 months ago|
|.env||2 weeks ago|
|.gitignore||7 months ago|
|.npmignore||1 year ago|
|.nvmrc||7 months ago|
|.travis.yml||8 months ago|
|LICENSE.md||1 year ago|
|README.md||2 weeks ago|
|_config.yml||4 months ago|
|background.js||3 years ago|
|best-practices.md||1 year ago|
|icon.png||5 months ago|
|index.html||1 week ago|
|manifest.json||1 year ago|
|meetings.md||8 months ago|
|nightwatch.js||8 months ago|
|nightwatch_debugger.js||1 year ago|
|package-lock.json||2 weeks ago|
|package.json||1 day ago|
|release-process.md||2 months ago|
|remix_screenshot.png||8 months ago|
|research-project.md||1 year ago|
|team-best-practices.md||6 months ago|
Remix is a browser-based compiler and IDE that enables users to build Ethereum contracts with Solidity language and to debug transactions.
To try it out, visit https://remix.ethereum.org.
https://github.com/ethereum/remix-ide/releases also gives others ways to use Remix locally. Please check it out.
Remix consists of many modules and in this repository you will find the Remix IDE (aka. Browser-Solidity).
gh-pages branch has always the latest stable build of Remix. It also contains a ZIP file with the entire build. Download it to use offline.
Note: It contains the latest release of Solidity available at the time of the packaging. No other compiler versions are supported.
Install npm and node.js (see https://docs.npmjs.com/getting-started/installing-node), then do:
Remix-ide has been published as an npm module:
npm install remix-ide -g remix-ide
Or if you want to clone the github repository (
wget need to be installed first) :
git clone https://github.com/ethereum/remix-ide.git git clone https://github.com/ethereum/remix.git # only if you plan to link remix and remix-ide repositories and develop on it. cd remix # only if you plan to link remix and remix-ide repositories and develop on it. npm install # only if you plan to link remix and remix-ide repositories and develop on it. npm run bootstrap # only if you plan to link remix and remix-ide repositories and develop on it. cd remix-ide npm install npm run setupremix # only if you plan to link remix and remix-ide repositories and develop on it. npm start
npm start and open
http://127.0.0.1:8080 in your browser.
Then open your
text editor and start developing.
The browser will automatically refresh when files are saved.
Most of the the time working with other modules (like debugger etc.) hosted in the Remix repository is not needed.
Some things to consider if you have trouble building the package:
nvm. You can find the version that is tested on Travis CI by looking at the log in the build results.
node --version npm --version nvm --version
apt-get install build-essential. After installing
Register new unit test files in
The tests are written using tape.
Run the unit tests via:
For local headless browser tests run
npm run test-browser
(requires Selenium to be installed - can be done with
npm run selenium-install)
Running unit tests via
npm test requires at least node v7.0.0
To run the Selenium tests via Nightwatch:
npm run build && npm run serve# starts web server at localhost:8080
npm run selenium-install# don't need to repeat
npm run selenium
npm run nightwatch_local_firefoxor
npm run nightwatch_local_chrome
Or run a specific test case:
- npm run nightwatch_local_ballot - 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_console - npm run nightwatch_local_remixd # remixd needs to be run
ballot tests suite requires to run
remixd tests suite requires to run
gist tests suite requires specifying a github access token in .env file.
gist_token = <token>
note that this token should have permission to create a gist.
If you would like to use this as a Chrome extension, you must either build it first or pull from the
gh-pages branch, both described above.
After that, follow these steps:
To see details about how to use Remix for developing and/or debugging Solidity contracts, please see our documentation page