Phpstorm Electron



Jetbrains products are professional tools and they are meant for professional users. The first time i made an electron app with more than 2000 lines of code was when i realized that vscode wasn't practical in large applications, but if your are just making some basic HTML5 project you're probably better off.

  • Making full screen effects with electron. The image is compressed and looks ugly. Using phpstorm to develop in wsl2 under windows, modifying wsl2.
  • Hey I use WSL2 and PHPStorm daily for work. So far I have found the absolute easiest setup so far (on going journey!) is keeping your git repositories in a WSL2 Distro I use Ubuntu 20.04. Then use that as your main environment, either creating a container off it using docker, or I setup Symfony CLI, PHP and Composer inside Ubuntu itself.

Features

Don't Compromise
on the Development Experience

The smartest editor

Use the full power of the modern JavaScript ecosystem – WebStorm’s got you covered! Enjoy the intelligent code completion, on-the-fly error detection, powerful navigation and refactoring for JavaScript, TypeScript, stylesheet languages, and all the most popular frameworks.

Mobile

  • Ionic
  • Cordova
  • React Native
  • Electron

Debugger

Debug your client-side and Node.js apps with ease in the IDE – put breakpoints right in the source code, explore the call stack and variables, set watches, and use the interactive console.

Debugger

Debug your client-side and Node.js apps with ease in the IDE – put breakpoints right in the source code, explore the call stack and variables, set watches, and use the interactive console.

Seamless tool integration

Take advantage of the linters, build tools, test runners, REST client, and other tools, all deeply integrated with the IDE. But any time you need Terminal, it's also available as an IDE tool window.

Unit testing

Run and debug tests with Karma, Mocha, Protractor, and Jest in WebStorm. Immediately see test statuses right in the editor, or in a handy treeview from which you can quickly jump to the test.

Integration with VCS

Use a simple unified UI to work with Git, GitHub, Mercurial, and other VCS. Commit files, review changes, and resolve conflicts with a visual diff/merge tool right in the IDE.

What’s New in WebStorm 2021.1

Smarter completion for JavaScript

ML-assisted completion for JavaScript and TypeScript is now enabled by default. Additionally, suggestions for symbol names have become a bit smarter.

Improvements for HTML and CSS

A built-in HTML preview, better support for Stylelint, and details about selector specificity in CSS will help you work more productively.

Usability enhancements

This version is packed with new settings for choosing editor font weight, the ability to maximize tabs in the split view, and fixes for a lot of known issues.

Why WebStorm

Get up and running quickly

Start working on your projects immediately instead of wasting time juggling multiple plugins. With a variety of built-in developer tools and out-of-the-box language and framework support, there’s everything needed for productive JavaScript development.

Increase your productivity

Don’t spend your time going back and forth between the terminal and text editor or on things that can be automated with the help of refactorings and quick fixes; it’s what the IDE is best at. It puts the most critical developer tools like the debugger and Git at your fingertips.

Write better code with less effort

Write cleaner and more reliable code as the IDE runs dozens of inspections as you type and promptly detects potential errors and redundancies. Save time exploring the code base with autocompletion that suggests which variables and methods are most relevant in the current context.

Swiftly find what you need

Get around your code faster regardless of how large your projects are. Jump to the definition for any class, function, method, variable, or component and find its usages in just a few clicks. Easily navigate through the file you have opened with an at-a-glance view of its structure.

Tailor the look and feel to your liking

Don’t feel like using the defaults? Adjust the appearance and behavior of the IDE by playing around with themes, code styles, plugins, and more, so that it fits your unique needs better. You can also automatically share your custom settings between different instances of WebStorm.

Join our customers

Teams all over the world use WebStorm. Join them and get the best development experience

What our customers say

Installation

latest version: 3.0.2
64-bit
macOS (.app)3.0.2
Windows (.exe)3.0.2
Debian (.deb)3.0.2
Fedora (.rpm)3.0.2
Other Linux distros (.AppImage)3.0.2

Project Goals

The goal of the project is to create a beautiful and extensible experience for command-line interface users, built on open web standards. In the beginning, our focus will be primarily around speed, stability and the development of the correct API for extension authors.

In the future, we anticipate the community will come up with innovative additions to enhance what could be the simplest, most powerful and well-tested interface for productivity.

Extensions

Extensions are available on npm. We encourage everyone to includehyper in the keywordsfield in package.json.

Then edit .hyper.js and add it to plugins

Hyper will show a notification when your modules are installed to .hyper_plugins.

Phpstorm Electron

Keymaps

All command keys can be changed. In order to change them, edit.hyper.js and add your desired change to keymaps.

Then Hyper will change the default with your custom change.

Example: 'window:devtools': 'Cmd+Alt+O'

Default keymaps:

Electron

Configuration

Config location

macOS~/Library/Application Support/Hyper/.hyper.js
Windows$Env:AppData/Hyper/.hyper.js
Linux~/.config/Hyper/.hyper.js

Note: config at ~/.hyper.js still supported, but will be ignored, if config in application directory present. Otherwise it will be moved to the application directory at first run.

The config object seen above in.hyper.js admits the following

PropertyDefaultDescription
updateChannel'stable'The update channel to receive updates from
fontSize12The default size in pixels for the terminal
fontFamily'Menlo, DejaVu Sans Mono, Lucida Console, monospace'The font family to use with optional fallbacks
uiFontFamily'-apple-system, BlinkMacSystemFont, Segoe UI, Roboto, ...'The font family to use for the UI with optional fallbacks
fontWeight'normal'The default font weight: 'normal' or 'bold'
fontWeightBold'bold'The font weight for bold characters: 'normal' or 'bold'
cursorColor'rgba(248,28,229,0.8)'The color of the caret in the terminal
cursorAccentColor'#000'The text color under BLOCK cursor
cursorShape'BLOCK'The shape of the caret in the terminal. Available options are: 'BEAM', 'UNDERLINE', 'BLOCK'
cursorBlink'false'If true, cursor will blink
foregroundColor'#fff'The color of the main text of the terminal
backgroundColor'#000'The color and opacity of the window and main terminal background
selectionColor'rgba(248,28,229,0.3)'The background color/opacity of the text selection in terminal
borderColor'#333'The color of the main window border and tab bar
css'Custom CSS to include in the main window
padding'12px 14px'CSS padding values for the space around each term
colors{ black: '#000000', red: '#ff0000', ... }A list of overrides for the color palette. The names of the keys represent the 'ANSI 16', which can all be seenin the default config.
shell'A path to a custom shell to run when Hyper starts a new session
shellArgs'['--login']'An array of shell arguments
env{}An object of environment variables to set before launching shell
windowSize[540, 380]The default width/height in pixels of a new window
scrollback1000The number of rows to be persisted in terminal buffer for scrolling
copyOnSelectfalseIf true, selected text will automatically be copied to the clipboard
quickEditfalseIf true, on right click selected text will be copied or pasted if no selection is present (true by default on Windows)
defaultSSHApptrueIf true, Hyper will be set as the default protocol client for SSH
modifierKeys{altIsMeta: false}Change the behaviour of modifier keys to act as meta key
showHamburgerMenutrue on Linux/Windows, false on macOSChange the visibility of the hamburger menu. Available options are: true, false
showWindowControls'Change the position/visibility of the window controls. Available options are: true, false, 'left'

Extensions API

Extensions are universal Node.js modules loaded by both Electron and the renderer process.

The extension system is designed around composition of the APIs we use to build the terminal: React components andRedux actions.

Instead of exposing a custom API method or parameter for every possible customization point, we allow you to intercept and compose every bit of functionality!

The only knowledge that is therefore required to successfully extendHyper is that of its underlying open source libraries.

You can find additional details about plugin developmentin the Hyper repository.

Your module has to expose at least one of these methods:

MethodInvoked fromDescription
onAppElectron

Invoked when the app first loads. If a plugin reloads, it's invoked again with the existing app.

Parameters:

appThe electron app.
onWindowElectron

Invoked when each window is created. If a plugin reloads, it's invoked again with the existing windows.

Parameters:

windowAn electron BrowserWindow.
onUnloadElectron

Invoked when a plugin is removed by the user.

Parameters:

appThe electron app.
decorateConfigElectron / Renderer

v0.5.0+. Allows you to decorate the user's configuration.
Useful for themeing or custom parameters for your plugin.

Parameters:

configThe config object
decorateEnvElectron

v0.7.0+. Allows you to decorate the user's environment by returning a modified environment object.

Parameters:

environmentThe environment object
decorateMenuElectron

Invoked with the Electron's Menu template. If a plugin reloads, it's called again and the menu is refreshed.

Parameters:

menuThe menu template object
decorateBrowserOptionsElectron

Allows you to decorate Electron's BrowserWindowoptions when a new window is created.

Parameters:

optionsThe BrowserWindow options object.
onRendererWindowRenderer

Invoked when a plugin is first loaded or subsequently reloaded in each window.

Parameters:

windowThe window object
middlewareRenderer

A custom Redux middleware that can intercept any action. Subsequently we invoke the thunkmiddleware, which means your middleware cannext thunks.

reduceUI
reduceSessions
reduceTermGroups
Renderer

A custom reducer for the ui,sessions or termgroups state shape.

stateThe Redux state object
actionThe action object
getTabsPropsRenderer

Passes down props from <Tabs>to the <Header> component. Must return the composed props object.

parentPropsProps form the parent component.
propsThe existing properties that will be passed to the component.
getTabPropsRenderer

Passes down props from <Tab>to the <Tabs> component. Must return the composed props object.

uidTab / Term uid
parentPropsProps form the parent component.
propsThe existing properties that will be passed to the component.
getTermGroupPropsRenderer

Passes down props from <Terms>to the <TermGroup> component. Must return the composed props object.

uidTermGroup uid
parentPropsProps form the parent component.
propsThe existing properties that will be passed to the component.
getTermPropsRenderer

Passes down props from <TermGroup>to the <Term> component. Must return the composed props object.

uidTerm uid
parentPropsProps form the parent component.
propsThe existing properties that will be passed to the component.
mapHyperState
mapTermsState
mapHeaderState
mapNotificationsState
Renderer

A custom mapper for the state properties thatcontainer componentsreceive. Note that for children components to get these properties, you have to pass them down using the corresponding methods (like getTermProps).

Must return an extended object of the map passed.

stateThe Redux global state
mapThe existing map of properties that will be passed to the component.
mapHyperDispatch
mapTermsDispatch
mapHeaderDispatch
mapNotificationsDispatch
Renderer

A custom mapper for the dispatch properties. Must return an extended object of the map passed.

dispatchThe Redux dispatch function
mapThe existing map of properties that will be passed to the component.
decorateHyper
decorateNotifications
decorateNotificationdecorateHeader
decorateTabs
decorateTabdecorateTerms
decorateTermGroup
decorateSplitPane
decorateTerm
Renderer

Invoked with the ReactComponentto decorate. Must return a Higher Order Component.

Parameters:

HyperThe ReactComponentconstructor.
envA collection of useful module references for building components.See below

Module loading

The user can hot-load and hot-reload plugins by pressing Command + R (refresh). Please strive to make plugins that don't require a complete restart of the application to work.

Notice

Plugins affecting the `BrowserWindow` will the effect on new windows after hot-reload.

In the future we might do this automatically.

When developing, you can add your plugin to.hyper_plugins/local and then specify it under the localPlugins array in.hyper.js. We load new plugins:

  • Periodically (every few hours)
  • When changes are made to the configuration file (plugins or localPlugins)
  • When the user clicks Plugins > Update all now

The process of reloading involves

  • Running npm prune and npm install in.hyper_plugins.
  • Pruning the require.cache in both electron and the renderer process
  • Invoking on* methods on the existing instances and re-rendering components with the fresh decorations in place.

Plugins location

macOS~/Library/Application Support/Hyper/.hyper_plugins
Windows$Env:AppData/Hyper/.hyper_plugins
Linux~/.config/Hyper/.hyper_plugins

Note: plugins at ~/.hyper_plugins still supported, but will be ignored, if plugins in application directory present. Otherwise they will be moved to the application directory at first run.

Note: on the main process, plugins are registered as soon as possible (we fire onLoad). On the browser, it's up to the user to trigger their load by pressing command+R. We put the user in control of the loading in this way to prevent them from losing critical work by extensions that reset state or don't preserve it correctly.

Decorating components

We give you the ability to provide a higher order component for every piece of the Hyper UI.
Its structure is as follows:

All the decorate* methods receive the following references in an object passed as the second parameter:

ReactThe entire React namespace.
notify

A helper function that shows a desktop notification. The first parameter is the title, the second is the optional body of the notification, and the third is another optional parameter which can be used to log details to the development console.

To pass these details, simply provide and object with anerror property containing the information to log.

NotificationThe Notification component in case you want to re-use it.

All the components accept the following two properties to extend their markup:

customChildrenAn array of Element or a singleElement to insert at the bottom of the component.
customChildrenBeforeThe same as the above property, but inserted as the first child element(s) of the component.

Your higher order component can supply a onDecoratedproperty to the decorated component to get a reference to its instance.

Your Term higher order component can supply anonCursorMovehandler property that be called when cursor has moved with an object parameter representing its relative position to Term origin:

xHorizontal position in pixels
yVertical position in pixels
widthCursor width in pixels
heightCursor height in pixels
colHorizontal position in columns
rowVertical position in rows

We encourage you to maintain compatibility with other decorators. Since many can be set, don't assume that yours is the only one.

For example, if you're passing children, compose potential existing values:

Or if you use onDecorated property

Phpstorm Electronico

Actions and Effects

All theRedux actionsare available for you to handle through your middleware and reducers. For an example, refer to the Hyperpowerreference plugin.

Side effects occur in two fundamental forms:

  • Some actions dispatch other actions based on state.
  • Some actions do async work by communicating over the RPC channel to the main process

In all cases, the side effect is passed as the effect key in the action and later handled by our middleware.

This means that you can override, compose or completely eliminate effects! In other words, this is how you can change the default functionality or behavior of the app.

As an example, consider the action we use to increase the font size when you press Command+=:

The underlying terminal

Hyper achieves a lot of its speed and functionality thanks to the power ofxterm.js

Additional APIs

The Electron app objects are extended with the following properties:

Webstorm Electron 调试

configAn Object with the config block from.hyper.js.
pluginsAn Object with helpers for plugins.
getWindowsA Function that returns an Set of all the open windows.
createWindowA Function that will create a new window. Accepts an optional callback that will be passed as the new window's init callback.

Electron BrowserWindow objects are extended with the following parameters:

rpcAn EventEmitter that allows for communication with the window process.
sessionsA Map of Sessionobjects which hold the communication with each term's pty..

Renderer windows are similarly extended with:

rpcAn EventEmitter that allows for communication with the window process.
storeThe Redux Store object. This allows access todispatch actions or read the global state withgetState.

The rpc object is symmetrical between browser and renderer process. The API is the same as Node.js, with the exception that it only admits a single object as its parameters only:

Example theme: Hyperyellow

The following extension simply alters the config to add CSS and yellow colors! Here's thecode.

Themes are simply plugins! Only one hook, decorateConfigis needed:

I grabbed the class names by inspecting the term with Devtools, which you can trigger from View -> Toggle Developer Tools. When you do so, notice that some classes are automatically generated and followed by a random nonce (e.g.: term_13hv8io). Ignore those: they change with every new window!

Notice the emphasis on playing nice with other extensions. Specifically, we create a new object, extend only the keys we are interested in, and we compose the CSS to preserve the user's setting and that of other authors':

Example extension: Hyperpower

The following extension renders particles as the caret moves:

Let's walk throughits code.
First, we intercept the Redux action SESSION_ADD_DATA. You can find the full list of actionsin the repository.

Notice that we don't re-dispatch the action, which means we never render the output of the command to the terminal. Instead, we dispatch an action of our own, which we grab in the uiReducerand later map:

We then want to decorate the <Term> component so that we can access the underlying caret.

However, <Term> is not a container that we can map props to. So we use getTermProps to pass the property further down:

The extension thenreturnsa higher order component to wrap <Term>. Notice we pass the onDecoratedproperty to access the base Term component and its DOM ref, and theonCursorMove property to use Hyper cursor API: