punchcard-cms

Node-based content management system

Downloads in past

Stats

StarsIssuesVersionUpdatedCreatedSize
punchcard-cms
301802.42.235 years ago6 years agoMinified + gzip package size for punchcard-cms in KB

Readme

Punchcard CMS Build Status Coverage Status Code Climate
Deploy
Headless Content Management System designed with content strategy at its heart. Built with Node.

Install and Usage

npm i punchcard-cms --save

const punchcard = require('punchcard-cms');

punchcard().then(app => {
  app.listen(8080);
})

Setting File Storage

Punchcard uses any Vinyl Adapter that your heart desires. A good first place to start is searching for vinyl on NPM. Punchcard assumes all vinyl adapters are named vinyl-adapter.

Developing Locally

Make sure PostgresSQL is set up locally (see below)
Install all the things
npm install

Run the following to run both the database and get the server running:
$ npm run dev

debug mode

Uses node's built in inspector. This works in chrome only.
$ npm run dev:database

then in a separate window:
$ npm run debug

There will be instructions and a link to paste into chrome shown in the terminal after this debug command is run.

Setting up PostgreSQL locally

  1. Make sure you have homebrew installed: /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

  1. brew update
  2. brew install postgres
  3. start the postgres server: postgres -D /usr/local/var/postgres

  1. open new terminal tab
  2. create a postgres user (it'll prompt for a password use W@ts0n): createuser punchcard -P

  1. Create local CMS database: createdb -O punchcard punchcard

  1. Create local test database: createdb -O punchcard punchcard_test

  1. reconnect to psql as new user: psql -d punchcard -U punchcard

  1. connect to db: \connect punchcard

Once you are connected you should be able to use psql cli syntax to check tables.
  • \d+ checks table relations
  • \l lists all available databases
  • select * from "database_name"; Displays all rows in database, replacing databasename with the table you want to see.
  • list all tables for user punchcard: \c punchcard \dt

Changelog

See the latest release for the most recent changelog