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

macOS
Windows
Debian

Install Homebrew

/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

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('https://getcomposer.org/installer', '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- https://raw.githubusercontent.com/creationix/nvm/v0.33.11/install.sh | 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 NPM
Via Git
npm create @phase2/particle particle && cd particle
git clone git@github.com:phase2/particle.git && 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 http://0.0.0.0:8080/pl or http://localhost:8080/pl and start editing files!