vapor-docs/getting-started/manual.md

currentMenu
getting-started-manual

Manual Quickstart

Learn how to create a Vapor project without the Vapor Toolbox using just Swift 3 and the Swift Package Manager.

If you'd prefer to use the toolbox, learn how to install it here.

This document assumes that the appropriate version of Swift is installed for Vapor 0.18.

Check

To check that your environment is compatible, run the following script:

curl -sL check.vapor.sh | bash

Make new project using SwiftPM

Open your terminal

For our example, we'll be using the Desktop folder.

cd ~/Desktop
mkdir HelloVapor
cd HelloVapor
swift package init --type executable

Your folder should look like this:

├── Package.swift
├── Sources
│   └── main.swift
└── Tests

Edit Package.swift

Open your Package.swift file:

open Package.swift

And add Vapor as a dependency. Here's how your file will look.

Package.swift

import PackageDescription

let package = Package(
    name: "HelloVapor",
    dependencies: [
        .Package(url: "https://github.com/vapor/vapor.git", majorVersion: 0, minor: 18)
    ]
)

We try to keep this document up to date, however, you can view latest releases here

Edit main.swift

A simple hello world:

import Vapor

let drop = Droplet()

drop.get("/hello") { _ in
  return "Hello Vapor"
}

drop.serve()

Build and Run

The first build command can take a while to fetch dependencies.

swift build
.build/debug/HelloVapor

If different, replace HelloVapor above with the name of your executable.

View

Go to your favorite browser and visit http://localhost:8080/hello