• Stars
    star
    65
  • Rank 472,303 (Top 10 %)
  • Language
    JavaScript
  • License
    MIT License
  • Created over 3 years ago
  • Updated 5 months ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

⚠️ Maintenance Mode

Keystone 5 has moved into maintenance mode!

We recommend starting any new projects using Keystone 6

Information on upgrading an existing keystone 5 project to keystone 6 can be found here

For more information please read our Keystone 5 and beyond post.



KeystoneJS


A scalable platform and CMS to build Node.js applications.

schema => ({ GraphQL, AdminUI })


Keystone comes with first-class GraphQL support, a highly extensible architecture, and a wonderful Admin UI.

Looking for Keystone v4.x / Keystone Classic? Head over to keystone-classic.

CI slack Supported by Thinkmill

Contents

What's new?

Keystone 5 is a complete re-imagining of older versions It builds on the lessons we learned over the last 5 years of the KeystoneJS' history and focuses on the things we believe are the most powerful features for modern web and mobile applications.

This means less focus on hand-holding Node.js template-driven websites and more focus on flexible architecture, a powerful GraphQL API with deep authentication & access control features, an extensible Admin UI and plugins for rich field types, file and database adapters, and session management.

We believe it's a powerful backend for rich React / Vue / Angular applications, Gatsby and Next.js websites, Mobile applications and more. It also makes a great Headless CMS.

Getting Started

To get up and running with a basic project template, run the following commands.

yarn create keystone-5-app my-app
cd my-app
yarn start

For more details and system requirements, check out the 5 Minute Quick Start Guide.

Documentation

The Keystone 5 API documentation contains a reference for all KeystoneJS packages.

For walk-throughs and discussions, see the Keystone 5 Guides documentation.

Version control

We do our best to follow SemVer version control within Keystone. This means package versions have 3 numbers. A change in the first number indicates a breaking change, the second number indicates backward compatible feature and the third number indicates a bug fix.

You can find changelogs either by browsing our repository, or by using our interactive changelog explorer.

A quick note on dependency management: Keystone is organised into a number of small packages within a monorepo. When packages in the same repository depend on each other, new versions might not be compatible with older versions. If two or more packages are updated, it can result in breaking changes, even though collectively they appear to be non-breaking.

We do our best to catch this but recommend updating Keystone packages together to avoid any potential conflict. This is especially important to be aware of if you use automated dependency management tools like Greenkeeper.

Contributing

This project follows the all-contributors specification.

Contributions of any kind are welcome!

You will find the set-up steps in this readme and full release processes and project guidelines in CONTRIBUTING.md.

Contributors

We'd like to start by thanking all our wonderful contributors: (emoji key):


Jed Watson

πŸ’»

Jess Telford

πŸ’»

Tim Leslie

πŸ’»

Mitchell Hamilton

πŸ’»

Joss Mackison

πŸ’»

Nathan Simpson

πŸ’»

Mike

πŸ’»

John Molomby

πŸ’» πŸ›

Dominik Wilkowski

πŸ’»

Ben Conolly

πŸ’» 🚧 πŸ”§

Jared Crowe

πŸ’»

Gautam Singh

πŸ’»

lukebatchelor

πŸ’»

Ticiana de Andrade

πŸ’»

aghaabbasq

πŸ’»

Ajay Narain Mathur

πŸ’»

mshavliuk

πŸ› πŸ’»

Wes Bos

πŸ“– πŸ€” 🚧

vlad-elagin

πŸ“–

Olya-Yer

πŸ›

1337cookie

πŸ“–

Mike

πŸ€” πŸ“† πŸ‘€ πŸ’»

Jordan Overbye

πŸ’» πŸ“–

prvit

πŸ“–

Kennedy Baird

πŸ“–

Thiago De Bastos

πŸ“–

Daniel Cousens

πŸ“–

Simon Vrachliotis

πŸ’‘ βœ… πŸ“Ή

Charles Dang

πŸ’» πŸ“–

dzigg

πŸ“–

Cristian Mos

πŸ“–

Arnaud Zheng

πŸ“–

Ashinze Ekene

πŸ“–

Fabyao

πŸ“–

Marcos RJJunior

πŸ’»

Ginkgoch

πŸ“–

MaisaMilena

πŸ“–

Martin Pham

πŸ›

Justin Smith

πŸ“–

Gabriel Petrovay

πŸ’» πŸ“–

Liam Clarke

πŸ“–

Vladimir Barcovsky

πŸ’»

Caleb Gray

πŸ’» ⚠️

frank10gm

πŸ’»

mbrodt

πŸ“–

Misha Zamkevich

πŸ’»

Matheus Chimelli

πŸ“–

Gita Permatasari Sujatmiko

πŸ“–

Andreas Borg

πŸ“–

Demo Projects

These projects are designed to show off different aspects of KeystoneJS features at a range of complexities (from a simple Todo App to a complex Meetup Site).

See the examples/README.md docs to get started.

Development Practices

All source code should be formatted with Prettier. Code is not automatically formatted in commit hooks to avoid unexpected behaviour, so we recommended using an editor plugin to format your code as you work. You can also run yarn format to prettier all the things. The lint script will validate source code with both ESLint and prettier.

Setup

Keystone 5 is set up as a monorepo, using Yarn Workspaces. Make sure to install Yarn if you haven't already.

First, clone the Keystone 5 repository

git clone https://github.com/keystonejs/keystone-5.git

Also make sure you have a local MongoDB server running (instructions).

Then install the dependencies and start the test project:

yarn
yarn dev

See examples/README.md for more details on the available demo projects.

Note For Windows Users

While running yarn on Windows, the process may fail with an error such as this:

Error: EPERM: operation not permitted, symlink 'C:\Users\user\Documents\keystone\packages\arch\packages\alert\src\index.js' -> 'C:\Users\user\Documents\keystone\packages\arch\packages\alert\dist\alert.cjs.js.flow'

This is due to permission restrictions regarding the creation of symbolic links. To solve this, you should enable Windows' Developer Mode and run yarn again.

Testing

Keystone uses Jest for unit tests and Cypress for end-to-end tests. All tests can be run locally and on GitHub.

Unit Tests

To run the unit tests, run the script:

yarn jest

Unit tests for each package can be found in packages/<package>/tests and following the naming pattern <module>.test.js. To see test coverage of the files touched by the unit tests, run:

yarn jest --coverage

To see test coverage of the entire monorepo, including files which have zero test coverage, use the special script:

yarn coverage

End-to-End Tests

Keystone tests end-to-end functionality with the help of Cypress. Each project (ie; tests/test-projects/basic, tests/test-projects/login, etc) have their own set of Cypress tests. To run an individual project's tests, cd into that directory and run:

yarn cypress:run

Cypress can be run in interactive mode from project directories with its built in GUI, which is useful when developing and debugging tests:

cd tests/test-projects/basic && yarn cypress:open

End-to-end tests live in project/**/cypress/integration/*spec.js. It is possible to run all cypress tests at once from the monorepo root with the command:

yarn cypress:run

NOTE: The output from this command will mix together the output from each project being tested in parallel. This is only recommended as sanity check before pushing code.

Code of Conduct

KeystoneJS adheres to the Contributor Covenant Code of Conduct.

License

Copyright (c) 2019 Jed Watson. Licensed under the MIT License.

More Repositories

1

keystone-classic

Node.js CMS and web app framework
JavaScript
14,641
star
2

keystone

The most powerful headless CMS for Node.js β€” built with GraphQL and React
TypeScript
9,024
star
3

keystone-demo

Less
931
star
4

generator-keystone

⚠️ Archived - Legacy KeystoneJS project generator for Yeoman
JavaScript
335
star
5

generator-keystone-react

⚠️ Archived - Legacy Yeoman generator for a KeystoneJS / React.js boilerplate project
JavaScript
87
star
6

storage

Storage.js is a Javascript library that gives you an easy and standardised access to any provider of your choice.
JavaScript
60
star
7

keystone-utils

⚠️ Archived - Legacy Node.js utility library used by KeystoneJS and you!
JavaScript
56
star
8

prisma-day-2021-workshop

Resources for Jed's Prisma Day 2021 Workshop
TypeScript
46
star
9

keystone-jamstack-plus

⚠️ Archived - Legacy Project
JavaScript
45
star
10

grappling-hook

Hooks for pre/post events used by KeystoneJS
JavaScript
42
star
11

create-keystone-app

CLI app that makes it easy to get started with Keystone
TypeScript
40
star
12

universal-keystone-boilerplate

⚠️ Archived - Legacy Keystone.JS boilerplate for Universal JavaScript projects using React.
JavaScript
34
star
13

keystone-graphql

⚠️ Archived - Legacy GraphQL Helpers for use with KeystoneJS
JavaScript
33
star
14

keystonejs-site

⚠️ Archived - Legacy keystonejs.com site and docs
Pug
31
star
15

keystone-starter

⚠️ Archived - Legacy Starter Project for Heroku (or any other) deployment
JavaScript
30
star
16

keystone-email

⚠️ Archived - Legacy email helper for KeystoneJS Apps
JavaScript
29
star
17

keystone-test-project

⚠️ Archived - Legacy KeystoneJS Project with various configurations for development and testing purposes
JavaScript
25
star
18

keystone-nightwatch-e2e

⚠️ Archived - Legacy end-to-end test framework for KeystoneJS applications.
JavaScript
17
star
19

keystone-storage-adapter-s3

⚠️ Archived - Legacy S3 Storage Adapter for KeystoneJS
JavaScript
17
star
20

keystone-6-railway-example

A simple example project showing how you might deploy Keystone 6 to Railway
TypeScript
15
star
21

eslint-config-keystone

⚠️ Archived - Legacy Shareable ESLint Config for Keystone's Coding Standards
JavaScript
15
star
22

keystone-6-heroku-example

A simple example project of showing how you might deploy Keystone 6 to Heroku
TypeScript
15
star
23

keystone-healthchecks

⚠️ Archived - Legacy Keystone Healthchecks Framework
JavaScript
9
star
24

keystone-react-todo-demo

TypeScript
7
star
25

keystone-storage-namefunctions

⚠️ Archived - Legacy utility functions for generating file names.
JavaScript
6
star
26

keystone-storage-adapter-azure

⚠️ Archived - Legacy Azure Storage Adapter for KeystoneJS
JavaScript
6
star
27

eslint-config-keystone-react

⚠️ Archived - Legacy Shareable ESLint Config for Keystone's Coding Standards with React Extensions
JavaScript
3
star
28

keystone-frontend-example

An example project of a keystone 6 app with a next frontend for use in lessons
TypeScript
3
star
29

keystone-metrics

⚠️ Archived - Legacy Keystone Metrics Tracking Package
JavaScript
2
star
30

fields-test-harness

⚠️ Archived - Legacy Project
JavaScript
1
star