Getting Started

System Requirements

Install System Dependencies

Skip to installing Particle if you already have Node, NPM, PHP, and Composer installed.

Run source ~/.bashrc or source ~/.zshrc after each step to ensure command is registered

OS-specific Instructions


Install Homebrew

/usr/bin/ruby -e "$(curl -fsSL"

Update Homebrew

brew update && brew upgrade

Install PHP 7.2

brew install php72

Install Composer

brew install composer

All Windows instructions are for WSL ("Bash on Ubuntu on Windows").

This guide also works on Debian-based distros like Ubuntu, Mint, etc.

Update APT

sudo apt-get update && apt-get upgrade

Install PHP 7.2

sudo apt-get install php7.2 php7.2-common

Download Composer

php -r "copy('', 'composer-setup.php');"
php -r "if (hash_file('SHA384', 'composer-setup.php') === '93b54496392c062774670ac18b134c3b3a95e5a5e5c8f1a9f115f203b75bf9a129d5daa8ba6a13e2cc8a1da0806388a8') { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;"
php composer-setup.php
php -r "unlink('composer-setup.php');"

Install Composer Globally

mv composer.phar /usr/local/bin/composer

Install NVM

curl -o- | bash

Install Node 10

This sets the system-wide Node to v10.

nvm install v10 && nvm alias default v10

Install NPM

npm install -g npm@latest

Install Particle

Via Git
npm create @phase2/particle particle && cd particle
git clone && cd particle

Install Particle Dependencies

Run this at the start of a project and any time package.json changes.

npm install && npm run setup

Start Particle

npm start

Open Particle

Simply visit or http://localhost:8080/pl and start editing files!