https://github.com/oliyh/spa-skeleton
A skeleton project for a ClojureScript Single Page Application backed by a Swagger API
https://github.com/oliyh/spa-skeleton
clojure clojurescript example single-page-app
Last synced: 16 days ago
JSON representation
A skeleton project for a ClojureScript Single Page Application backed by a Swagger API
- Host: GitHub
- URL: https://github.com/oliyh/spa-skeleton
- Owner: oliyh
- License: epl-1.0
- Created: 2016-01-07T18:57:50.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2017-03-13T19:38:29.000Z (about 8 years ago)
- Last Synced: 2025-03-30T23:04:11.834Z (about 2 months ago)
- Topics: clojure, clojurescript, example, single-page-app
- Language: Clojure
- Size: 249 KB
- Stars: 20
- Watchers: 3
- Forks: 4
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# spa-skeleton
A skeleton project for a ClojureScript Single Page Application (SPA) backed by a Swagger API.
The aim is to provide basic wiring from which an application can be rapidly developed.
## Clojure and ClojureScript, side by side
Include the following in your emacs init.el:
```
(custom-set-variables
'(cider-cljs-lein-repl
"(do (use 'figwheel-sidecar.repl-api) (start-figwheel!) (cljs-repl))"))
```
In the older versions of CIDER the variable is called `cider-cljs-repl` instead.
To start both REPLs simultaneously press `C-c M-J`.
Figwheel will be started and a piggieback connection into the browser's Javascript VM will be automatically established.
## Server
The server consists of a Pedestal web server which serves a root for the SPA and a [Swagger API](http://swagger.io/) provided by [pedestal-api](https://github.com/oliyh/pedestal-api).
You can start it from a new Clojure REPL by loading the dev namespace and running start:
```clojure
user> (dev)
dev> (start)
```
## SPA
The SPA is a ClojureScript application which can be built and developed using [Figwheel](https://github.com/bhauman/lein-figwheel).
Once the server is started, open http://localhost:8080 to connect the ClojureScript REPL. You should see the following in the CLJS REPL:
```clojure
Prompt will show when Figwheel connects to your application
To quit, type: :cljs/quit
;; => nil
cljs.user>
```
You can make changes to the CLJS source files under `/src/cljs/`, save them, and see the
results hot-loaded into your browser with no refresh required. You can evaluate code in the CLJS REPL just like you would in a CLJ REPL.
## ClojureScript builds
There are two different builds provided: the default `dev` and; `devcards`. In the ClojureScript REPL you can switch builds using `(switch-to-build "devcards")`. In order to use the devcards build you will need to view [cards.html](http://localhost:8080/cards.html) instead of the index.
Devcards provides a way to test components interactively and in isolation, see more at [Devcards](https://github.com/bhauman/devcards).
## Building and running from uberjar
```bash
$ lein uberjar
$ java -Dnomad.env=dev -jar target/uberjar/spa-skeleton-standalone.jar
```
## License
Copyright © 2016 oliyh
Distributed under the Eclipse Public License either version 1.0 or (at
your option) any later version.