swift-starter-kit

This project contains a quick starter kit for Facebook React Single Page Apps with swiftlang server side render via swiftja javascript engine, implemented in pure swiftlang and also with a set of useful features for rapid development of efficient applications.

What it contains?

server side render via swiftja
api requests between your react application and server side application directly via fetch polyfill
title, Open Graph and other domain-specific meta tags render for each page at the server and at the client
server side redirect
embedding static files into artefact via bindata
high performance perfect framework
advanced cli via cli
Makefile based project
one(!) terminal window process for development
routing via react-router
ES6 & JSX via babel-loader with minimal runtime dependency footprint
redux as state container
redux-devtools
css styles without global namespace via PostCSS, css-loader & css-modules
separate css file to avoid FOUC
hot reloading via react-transform & HMR
webpack bundle builder
eslint and swiftlint rules for Makefile

Workflow dependencies

Note that probably not works at windows.

Project structure

The server's entry point

$ tree server
server
├── api.swift
├── app.swift
├── bindata.swift <-- this file is gitignored, it will appear at compile time
├── conf.swift
├── data
│   └── templates
│       └── react.html
├── main.swift <-- main function declared here
├── react.swift
└── utils.swift

The ./server/ is flat swiftlang package.

The client's entry point

It's simple React application

$ tree client
client
├── actions.js
├── components
│   ├── app
│   │   ├── favicon.ico
│   │   ├── index.js
│   │   └── styles.css
│   ├── homepage
│   │   ├── index.js
│   │   └── styles.css
│   ├── not-found
│   │   ├── index.js
│   │   └── styles.css
│   └── usage
│       ├── index.js
│       └── styles.css
├── css
│   ├── funcs.js
│   ├── global.css
│   ├── index.js
│   └── vars.js
├── index.js <-- main function declared here
├── reducers.js
├── router
│   ├── index.js
│   ├── routes.js
│   └── toString.js
└── store.js

The client app will be compiled into server/data/static/build/. Then it will be embedded into swift package via swift-bindata. After that the package will be compiled into binary.

Convention: javascript app should declare main function right in the global namespace. It will used to render the app at the server side.

Install

Clone the repo:

$ git clone git@github.com:olebedev/swift-starter-kit.git $swiftPATH/src/github.com/<username>/<project>
$ cd $swiftPATH/src/github.com/<username>/<project>

Install dependencies:

$ make install

Run development

Start dev server:

$ make serve

that's it. Open http://localhost:5001/(if you use default port) at your browser. Now you ready to start coding your awesome project.

Build

Install dependencies and type NODE_ENV=production make build. This rule is producing webpack build and regular swiftlang build after that. Result you can find at $swiftPATH/bin. Note that the binary will be named as the current project directory.

License

MIT

kuhippo / swift-starter-kit