Perfect App Template Starter Project
This repository holds a template which can be cloned to serve as a starter for new work. It builds with Swift Package Manager and produces a stand-alone HTTP executable.
It includes ready-to-go Local Authentication routes and setup with sessions, using PostgreSQL as a backend.
All you need to do is complete the indormation in the
/config/ApplicationConfiguration.json files with your own information and run.
The concept behind this template is to provide a structure for a larger project to grow into. It contains an HTTP Server config that loads from pre-separated Filters and Routes, a JSON config loader, and directories into which you can organize your handlers, objects and utility functions.
Compatibility with Swift
The master branch of this project currently compiles with Xcode 8.3 or the Swift 3.1 toolchain on Ubuntu.
Building & Running
The following will clone and build an empty starter project and launch the server on port 8181.
git clone https://github.com/PerfectlySoft/Perfect-Local-Auth-PostgreSQL-Template.git cd Perfect-Local-Auth-PostgreSQL-Template swift build .build/debug/PerfectLocalAuthPostgreSQLTemplate
You should see the following output:
[INFO] Starting HTTP server localhost on 0.0.0.0:8181
This means the server is running and waiting for connections. Access http://localhost:8181/ to see the greeting. Hit control-c to terminate the server.
The template contains the following directories:
The config directory contains two files
ApplicationConfigurationLinux.json. Add configuration options to these files and add them to be read and assigned in the
config() function in
ApplicationConfiguration_copy.json file and rename to
ApplicationConfiguration.json and populate with your own information.
This is for static files and Mustache template files.
The files in this directory are meant to drive configuration of your application. Add configuration options, filters, and routes here.
The files in this directory are handler functions for JSON and Web routes.
This directory is intended as the location for where you place your object classes and structs. There is also an
initializeObjects.swift file for invoking setup functions in one convenient place.
Place utility and helper functions here.
We use JIRA for all bugs and support related issues.
If you find a mistake, bug, or any other helpful suggestion you'd like to make on the docs please head over to http://jira.perfect.org:8080/servicedesk/customer/portal/1 and raise it.
A comprehensive list of open issues can be found at http://jira.perfect.org:8080/projects/ISS/issues
For more information on the Perfect project, please visit perfect.org.