2015-09-03 13:31:52 -04:00
|
|
|
# Rookeries
|
|
|
|
|
2017-10-25 01:00:28 -04:00
|
|
|
A developer and designer friendly CMS for building gorgeous micro-sites,
|
|
|
|
blogs and portfolios.
|
2015-09-03 13:31:52 -04:00
|
|
|
|
|
|
|
**Rookeries** is:
|
|
|
|
|
2018-08-08 16:42:22 -04:00
|
|
|
- Powered by Rust and CouchDB on the server side.
|
2017-11-02 09:19:23 -04:00
|
|
|
- Uses preact, mobx, ES2017 and webpack to build responsive single page apps.
|
2016-04-09 08:55:14 -04:00
|
|
|
- Licensed under the Affero GNU General Public License (AGPL) version 3.0.
|
2015-09-03 13:31:52 -04:00
|
|
|
|
2016-10-25 17:47:05 -04:00
|
|
|
## Build Status:
|
2015-09-03 13:31:52 -04:00
|
|
|
|
2016-12-16 23:13:53 -05:00
|
|
|
- **CircleCI**: [![CircleCI](https://circleci.com/bb/dorianpula/rookeries.svg?style=svg)](https://circleci.com/bb/dorianpula/rookeries "CircleCI builds")
|
2017-03-15 11:15:52 -04:00
|
|
|
- **Docker**:
|
|
|
|
[![](https://img.shields.io/docker/automated/dorianpula/rookeries.svg)](https://hub.docker.com/r/dorianpula/rookeries/ "Docker Hub")
|
|
|
|
[![](https://img.shields.io/docker/pulls/dorianpula/rookeries.svg)](https://hub.docker.com/r/dorianpula/rookeries/ "Docker Hub")
|
|
|
|
[![](https://img.shields.io/docker/stars/dorianpula/rookeries.svg)](https://hub.docker.com/r/dorianpula/rookeries/ "Docker Hub")
|
|
|
|
[![](https://images.microbadger.com/badges/image/dorianpula/rookeries.svg)](https://microbadger.com/images/dorianpula/rookeries "Rookeries Docker size courtesy of microbadger.com")
|
2016-04-09 08:55:14 -04:00
|
|
|
|
|
|
|
## Installation
|
|
|
|
|
2017-10-25 01:00:28 -04:00
|
|
|
*Rookeries* is heavily under development and once things stabilize there will
|
|
|
|
be a user friendly installation guide. In the meantime, please refer to the
|
|
|
|
development guide below.
|
2016-04-09 08:55:14 -04:00
|
|
|
|
|
|
|
## Development
|
|
|
|
|
|
|
|
*Rookeries* uses the following technologies:
|
|
|
|
|
2018-08-08 16:42:22 -04:00
|
|
|
- Rust 1.27+
|
2017-09-24 14:16:17 -04:00
|
|
|
- Python 3.6
|
2018-08-08 16:42:22 -04:00
|
|
|
- NodeJS 10 + ES2017
|
2017-10-25 01:00:28 -04:00
|
|
|
- CouchDB 2x
|
2016-10-25 17:42:56 -04:00
|
|
|
- Docker + docker-compose
|
2016-04-09 08:55:14 -04:00
|
|
|
|
|
|
|
### Getting Started
|
|
|
|
|
2017-10-25 01:00:28 -04:00
|
|
|
**Rookeries** requires newer versions of Docker (<1.9.0) and
|
|
|
|
docker-compose (<1.8.0).
|
2016-04-09 08:55:14 -04:00
|
|
|
|
2016-10-25 17:47:05 -04:00
|
|
|
1. [Install docker-compose](https://docs.docker.com/compose/install/)
|
2016-12-16 21:34:20 -05:00
|
|
|
1. Build Rookeries: `make build`
|
|
|
|
1. Run tests: `make test`
|
2017-03-27 08:47:15 -04:00
|
|
|
- `make test-api` to run API server tests.
|
|
|
|
- `make test-ui` to run UI tests.
|
2016-12-16 21:34:20 -05:00
|
|
|
1. Run demo: `make demo`
|
2017-10-25 01:00:28 -04:00
|
|
|
1. Run the invoke scripts on a running Rookeries container with:
|
|
|
|
`docker-compose exec rookeries inv $MY_TASK`
|
2016-10-25 17:47:05 -04:00
|
|
|
- Use `inv -l` to list the available invoke tasks.
|
2017-10-25 01:00:28 -04:00
|
|
|
1. When running the demo, navigate to the main Rookeries page in a browser:
|
|
|
|
[http://localhost:5000/](http://localhost:5000/)
|
2017-03-27 08:47:15 -04:00
|
|
|
|
2017-11-02 09:19:23 -04:00
|
|
|
Please refer to the [Development Notes](docs/devnotes.md) for more details.
|
2018-08-12 00:04:35 -04:00
|
|
|
|
|
|
|
### Local Server Setup
|
|
|
|
|
|
|
|
To run the Rust server locally, remember to initialize the local dev environment
|
|
|
|
variables using: `export $(cat dev.env | xargs)`
|