DEPRECATION NOTICE: Please do not edit this wiki. Instead submit pull requests tohttps://github.com/clojure/clojurescript-site

The up to date version of this page can be found athttps://clojurescript.org/community/reporting-issues

It's important that before submitting any issue that you have athorough understanding of theQuick Start first. Even if you are anexperienced ClojureScript developer this is required reading.

It's helpful, but not essential, to first check theexisting bug reports, themailing list,or the Freenode #clojurescript IRC channel or Slack channels and ensurethat the issue hasn't been reported before.

Also, it can be helpful to ensure that you are running the latestreleased version of ClojureScript. Also, checking againstClojureScript master is prudent—frequently when bugs are found, fixesare quickly committed (see instructions below).

It is essential, however, to report the bug using ClojureScriptonly. Downstream tooling often interacts with the ClojureScriptcompiler in non-trivial ways, and the best way to isolate the issue toClojureScript is to remove them from the report altogether.

Please report issues by building the uberjar from master and using this to verifythe issue. Do not use any other 3rd party tooling (Maven, Leiningen, Boot).When creating issues please add all relevant instructions and codeto reproduce to the ticket directly or via additional comments. Pleasedo not attach projects, links to projects, links to gists / pastebins,or zips.

Note: Bootstrap issues may require special consideration. Please seeReporting Bootstrap Issues for more details.

Make a checkout of the ClojureScript repository. From the root of theproject run the following:

./script/uberjar

This will createtarget/cljs.jar.

When verifying issues it may be useful to first check that the issuehas not already been resolved in master.Do not report issues usingthis method, it's only for convenience when verifying master yourself.Make a checkout of the ClojureScript repository. From the root of theproject run the following:

./script/build

This will install ClojureScript into your local Maven. Make note of theversion when it scrolls by. Use this as appropriate for your tooling.