Quine's fork of "Hyper" by Vercel, A terminal built on web technologies
Find a file
2019-12-08 15:57:37 +01:00
.circleci Update xterm to v4 (#3830) 2019-10-06 20:51:56 +02:00
.github PR template typo: fulfil/fulfill (#3710) 2019-05-31 17:30:30 -04:00
.vscode Update Electron to v6 (#3785) 2019-10-10 21:20:26 +02:00
app port es5 code to es6 2019-11-29 22:09:10 +01:00
assets Windows titlebar improvements (#1307) 2017-01-10 21:45:49 -08:00
bin Update Electron to v6 (#3785) 2019-10-10 21:20:26 +02:00
build Improve Hyper 3 Canary and Stable icons (#3466) 2019-02-09 14:40:39 +01:00
cli syntax fixes in cli/api.js 2019-12-08 01:37:53 +01:00
lib port es5 code to es6 2019-11-29 22:09:10 +01:00
test CLI : Fix package existence check for scoped packages (#3044) 2018-05-23 23:32:38 +02:00
.editorconfig Fix for markdown files (#618) 2016-08-14 21:10:41 +02:00
.eslintignore Rename compiled_app to target and add target in eslintignore 2019-10-08 21:42:51 +02:00
.gitattributes mark bin/* as vendored code to get correct language stats 2019-10-20 22:20:21 +02:00
.gitignore add vscode workspace settings to .gitignore 2019-11-28 14:22:22 +01:00
.travis.yml Upgrade eslint to v6 and add TypeScript linting (#3843) 2019-10-03 02:56:50 +02:00
.yarnrc Update Electron to v6 (#3785) 2019-10-10 21:20:26 +02:00
appveyor.yml update appveyor to VS 2019 2019-10-16 19:10:08 +02:00
jsconfig.json Disable VSCode type chekcing (#2767) 2018-03-17 18:52:18 +01:00
LICENSE Point Spectrum badge to correct location (#3166) 2018-08-09 13:15:48 +02:00
package.json Bump style-loader from 1.0.0 to 1.0.1 2019-12-08 15:57:37 +01:00
PLUGINS.md Document that plugins can require Electron 2019-10-03 23:52:10 +02:00
README.md Add a way to fix macos compiler error to README.md (#3680) 2019-07-31 00:07:12 +02:00
release.js Upgrade eslint to v6 and add TypeScript linting (#3843) 2019-10-03 02:56:50 +02:00
tsconfig.json Rename compiled_app to target and add target in eslintignore 2019-10-08 21:42:51 +02:00
webpack.config.js port js files in lib and lib/containers to ts (#3957) 2019-11-11 16:21:42 +01:00
yarn.lock Bump style-loader from 1.0.0 to 1.0.1 2019-12-08 15:57:37 +01:00

macOS CI Status Windows CI status Linux CI status Changelog #213 Join the community on Spectrum

For more details, head to: https://hyper.is

Usage

Download the latest release!

Linux

Arch and derivatives

Hyper is available in the AUR. Use an AUR package manager like aurman

aurman -S hyper

macOS

Use Homebrew Cask to download the app by running these commands:

brew update
brew cask install hyper

Windows

Use chocolatey to install the app by running the following command (package information can be found here):

choco install hyper

Note: The version available on Homebrew Cask, Chocolatey, Snapcraft or the AUR may not be the latest. Please consider downloading it from here if that's the case.

Contribute

Regardless of the platform you are working on, you will need to have Yarn installed. If you have never installed Yarn before, you can find out how at: https://yarnpkg.com/en/docs/install.

  1. Install necessary packages:
  • Windows
    • Be sure to run yarn global add windows-build-tools from an elevated prompt (as an administrator) to install windows-build-tools.
  • macOS
    • Once you have installed Yarn, you can skip this section!
  • Linux (You can see here what your Linux is based on.)
    • RPM-based
      • GraphicsMagick
      • libicns-utils
      • xz (Installed by default on some distributions.)
    • Debian-based
      • graphicsmagick
      • icnsutils
      • xz-utils
  1. Fork this repository to your own GitHub account and then clone it to your local device
  2. Install the dependencies: yarn
  3. Build the code and watch for changes: yarn run dev
  4. To run hyper
  • yarn run app from another terminal tab/window/pane
  • If you are using Visual Studio Code, select Launch Hyper in debugger configuration to launch a new Hyper instance with debugger attached.
  • If you interrupt yarn run dev, you'll need to relaunch it each time you want to test something. Webpack will watch changes and will rebuild renderer code when needed (and only what have changed). You'll just have to relaunch electron by using yarn run app or VSCode launch task.

To make sure that your code works in the finished application, you can generate the binaries like this:

yarn run dist

After that, you will see the binary in the ./dist folder!

Known issues that can happen during development

Error building node-pty

If after building during development you get an alert dialog related to node-pty issues, make sure its build process is working correctly by running yarn run rebuild-node-pty.

If you are on macOS, this typically is related to Xcode issues (like not having agreed to the Terms of Service by running sudo xcodebuild after a fresh Xcode installation).

Error with c++ on macOS when running yarn

If you are getting compiler errors when running yarn add the environment variable export CXX=clang++

Error with codesign on macOS when running yarn run dist

If you have issues in the codesign step when running yarn run dist on macOS, you can temporarily disable code signing locally by setting export CSC_IDENTITY_AUTO_DISCOVERY=false for the current terminal session.