https://github.com/hnryjms/Expressive

An Expressive CMS built on Express and Node.js
https://github.com/hnryjms/Expressive

Last synced: 13 days ago
JSON representation

An Expressive CMS built on Express and Node.js

• Host: GitHub
• URL: https://github.com/hnryjms/Expressive
• Owner: hnryjms
• License: gpl-3.0
• Created: 2014-12-27T18:35:01.000Z (almost 10 years ago)
• Default Branch: master
• Last Pushed: 2017-07-31T13:11:00.000Z (over 7 years ago)
• Last Synced: 2023-03-25T10:42:13.021Z (over 1 year ago)
• Language: JavaScript
• Homepage:
• Size: 677 KB
• Stars: 8
• Watchers: 3
• Forks: 1
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Expressive

[![Build Status](https://travis-ci.org/hnryjms/Expressive.svg?branch=master)](https://travis-ci.org/hnryjms/Expressive)

[![Dependency Status](https://david-dm.org/hnryjms/Expressive.svg)](https://david-dm.org/hnryjms/Expressive)

[![devDependency Status](https://david-dm.org/hnryjms/Expressive/dev-status.svg)](https://david-dm.org/hnryjms/Expressive#info=devDependencies)

[![Coverage Status](https://img.shields.io/coveralls/hnryjms/Expressive.svg)](https://coveralls.io/r/hnryjms/Expressive?branch=master)

Expressive is a beautiful CMS for [Express](http://expressjs.com) and [Node.js](http://nodejs.org). Expressive is awesome, extendable, themeable, testable and growing.

**Expressive is in a very unstable alpha state**

## Getting Started

Expressive is not ready for production use, but here is how you can start contributing to Expressive.

	$ npm install

The rest of the installation should be hooked into the postinstall process (`bower install`, etc), and should complete successfully.

To run Expressive, you have a number of options. My favorite is using [Nodemon](http://nodemon.io) to watch for changes. Expressive even includes `.nodemonignore` to make sure Nodemon watches the right files and ignores ones that don't matter (usually). **You also** need to make sure you have MongoDB available somewhere. The Expressive installer should guide you through connecting the database and setting up your first user.

	$ DEBUG=expressive:* node ./bin/www

	$ DEBUG=expressive:* npm start

	$ DEBUG=expressive:* nodemon

Once Expressive is running, open  and follow the setup guide. You'll need to have a MongoDB instance running. Once you're in, you can sign into the administration pages at . *Most unfinished areas of Expressive will give you a 404 error.*

## Extensions

An example extension is included with Expressive, showing how awesome the extendability of Expressive is. Extensions are usually entirely separate Express apps with access to the parent app for hooking in their features.

**Much of Expressive's extendability is unfinished, and continuously changing**

**TODO:** Write better documentation.

## Contributing

Checkout the [Expressive GitHub Wiki](https://github.com/hnryjms/Expressive/wiki/Development) for more information about the development cycle.

To make contributions to Expressive, follow the steps below to get your changes in the CMS. My mission with Expressive is to build a largely *extendable* CMS, so try to write code that allows for some awesome extensions around it.

1. Fork the `hnryjms/Expressive` repo

1. Commit changes to your fork

1. Create a pull request back into the original

1. Win

Make sure to run & write tests for your cool things.

## Testing

We use the [mocha](http://mochajs.org/) testing framework. To run tests, first install the module with development dependencies.

	$ npm install

You can run tests through npm or through mocha. Both will have the same result.

	$ npm test

	$ mocha test

## License

Expressive is available under the GNU GPL v3.0 License.

See the [LICENSE](https://github.com/hnryjms/Expressive/blob/master/LICENSE) for the more information about the GNU licence legal terms.