Skip to content

๐ŸŒ๏ธ Launch a Development Server directly from Sublime Text

License

Notifications You must be signed in to change notification settings

molnarmark/sublime-live-server

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

32 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

Launch a Development Server directly from Sublime Text!

๐Ÿ“‹ Introduction

This package integrates the Live Server Node package, giving the ability to launch a local development server to serve content directly from Sublime Text.

๐Ÿ’ก About Live Server:

Live Server is Node.js tool that spins up a local development server in the given directory.

It features live browser reloading, which simply means that your browser will automatically refresh the page when any change is made to your HTML & CSS files.

Useful for static sites, SPAs, and general HTML/CSS fiddling.

โ—Prerequisites

You need the following software installed to use Live Server.

To install Live Server globally using npm, run:

npm install -g live-server

To install Live Server globally using Yarn, run:

yarn global add live-server

๐ŸŒ€ Installation

Package Control

This package is available in Package Control under the name LiveServer.

As a Repository

โ“ Usage

This package exposes 3 commands that can be used directly via the Command Palette, or bound to keys. These are:

Live Server: Start

  • Maps to live_server_start

Live Server: Stop

  • Maps to live_server_stop

Live Server: Open In Browser

  • Maps to live_server_open_in_browser

Status bar messages with indicator emojis are implemented into the package, displaying information in cases such as:

  • ๐ŸŽ‰ Live Server running
  • โŒ Live Server stopped
  • โœ”๏ธ Live Server status

When the development server is running, a status message will be shown in the status bar indicating that the server is running. This is shared across all views in the opened instance.

๐Ÿ”จ Settings

To change your settings, bring up the Command Palette and select: Preferences: Live Server Settings

The default settings for linux are the following:

// Note: These are just mappings to https://github.com/tapio/live-server#usage-from-command-line
{
  "node_executable_path": "/usr/bin/node",
  "global_node_modules_path": "/usr/local/lib/node_modules",
  "port": 8080,
  "address": "localhost",
  "cors": true,
  "browser": "default",
  "nobrowser": false,
  "wait": 100
}

node_executable_path

  • Path to the Node runtime executable. You can run whereis node in your terminal to find this.
    • In Windows Command Prompt, run where node
  • default value: /usr/bin/node

global_node_modules_path

  • Path to the default node_modules directory. You can run npm root -g or yarn global bin in your terminal to find this.
  • default value: /usr/local/lib/node_modules

port

  • The default port for the server.
  • default: 8080

address

  • Host address. This should always be either localhost or 127.0.0.1.
  • default: localhost

cors

  • Enables CORS for any origin.
  • default: true

browser

  • Specifies which browser to use.

  • Valid values are:

    • default
    • google-chrome
    • firefox
  • default: default

nobrowser

  • By setting this to true, the browser will not open the server by default
  • default: false

wait

  • Wait this amount of milliseconds before reloading the page after a change
  • default: 100

๐Ÿ”– Credits