This getting started guide walks you through the core features of Nuclide and aims to get you productive quickly. See Basics for more information on using Nuclide’s editing features.
- Adding a Project
- Quick Launch Menu
- Quick Open
- Remote Connection
- Diff View
The installation guides provide detailed information to install Nuclide on your platform, but if you have already met the platform dependent prerequisites (macOS | Linux), you can install Nuclide easily from within Atom itself.
- Open Atom.
Atom | Preferences(
Edit | Preferenceson Linux and
File | Settingson Windows) to bring up the Settings tab.
- In the Settings tab, select Install from the list at the left.
- In the search box, type “Nuclide” and press the
- Click the Install button for the
Installing Nuclide within the Atom Packages UI is the recommended method, however you can install Nuclide from the command-line, if you wish, using:
$ apm install nuclide
If you want features such as Quick Open, Remote Development, and Mercurial support to work correctly, you also need to install Watchman and ensure it is in your
$PATH environment variable. There are other recommended package installations as well.
After installation, launch Nuclide by opening Atom. Once Atom is open, you should see the Nuclide Home page.
- The left side-pane is the Nuclide Project Explorer.
- The main pane contains introductory information about Nuclide and the Quick Launch Menu. This is also where you will edit your files (just like in normal Atom).
- The bottom status bar shows you error and health statistics.
Adding a Project
To add a project, click the Add Project Folder button in the left side-pane, use the
Cmd-Shift-O keyboard shortcut (
Ctrl-Shift-O on Linux), or choose
File | Add Project Folder from the Atom menu bar.
After adding a project you will see the root of your project at the top of the Project Explorer’s File Tree with all files and folders as a tree hierarchy underneath it.
Quick Launch Menu
On the Nuclide Home page you will find the Quick Launch Menu that gives quick access to many of the popular features of Nuclide. Click the Try It button of any feature to use it.
The Quick Open feature gives you access to Nuclide’s file
search mechanism, including OmniSearch, which quickly displays recently opened files, quick searches for files based on partial names, and depending on the project, can search within files for symbols, etc. Click Try It or use the
Cmd-T keyboard shortcut (
Ctrl-T on Linux) to access the feature.
You can also search by filenames in your project, filenames of currently open files, and see which files have been recently opened.
Nuclide provides the ability to do remote development out of the box. This allows you to have Nuclide installed on a local machine, your project on a remote machine, and have your editing experience be seamless between the two.
Nuclide provides a server that bridges your local client with the remote development machine. In order for remote development to work correctly, you must meet the prerequisites on the remote machine before installing the Nuclide server.
Once the prerequisites are met, you can install the server on the remote machine.
In order to connect to your remote project, click on the Try It button next to
Remote Connection in the Quick Launch Menu. You can also select
Nuclide | Remote Projects | Connect to Remote Project...,
Ctrl-Shift-Cmd-C keyboard shortcut, or click Add Remote Project Folder
in the Project Explorer (however, please note that if you have other projects open that button will not be there).
Enter all the necessary credentials, including the username for logging into the remote server, the
server’s address, and the actual root directory of the remote project you want to open. Then, if you installed the Nuclide Server as instructed, the Remote Server Command is
Any changes you make in the local Nuclide editor will be communicated back to the remote server and properly synchronized.
Nuclide has built-in support for Mercurial-based repositories. If your project is using Mercurial, one of the features that may help your workflow is the Diff View. This allows you to quickly see what has changed in the files you have modified. It shows what has changed from the current committed revision which you are tracking.
To access the Diff View, click the Try It button, use the
Alt-Cmd-Shift-D keyboard shortcut, or select
Nuclide | Source Control | Toggle Diff View after making a change to one of the files in your Mercurial project.
When the Diff View tab appears, click on a changed file in the right pane to have the Diff View window highlight any changes.