noviny/musescodejs

New website powered by Keystone

MusesCodeJS

Project link

A free, open source website. Powered by Keystone, Next.js and Emotion.

Note: This is a work in progress and we'd love your contributions. Please see the read the issues and contributing guidelines if you'd like to help make this project better.

Requirements to run locally

Before we start, check that your computer or server meets the following requirements:

Node.js >= 10.x: Node.js is a server platform which runs JavaScript. MongoDB >= 4.x: MongoDB is a powerful NoSQL document storage database.

To run locally:

Make sure mongodb-community status is started by running brew services list.

Create a .env file based on the example available in this folder (.env.example) with the right information or create free accounts for these services.

Make sure you installed all dependencies running yarn before start yarn dev

Start: yarn dev

Mocking Database

If it's the first time you are running it locally you can mock a DB with initial content you can add the following code inside the index.js in the root.

const initialiseData = require('./initialData');

const keystone = new Keystone({
  name: 'MusesCodeJS',
  adapter: new MongooseAdapter({ mongoUri: 'mongodb://localhost/muses-code-js' }),
  onConnect: initialiseData,
});

Access Admin Area

Keystone Admin UI: http://localhost:3000/admin username: [email protected] password: 12345678 (defined on .env file)

Installing MongoDB

MacOS The simplest way to install MongoDB is using Homebrew. Refer the official guide for more information.

Windows Follow the official guide for installing MongoDB on Windows.

Other Platforms Downloads and instructions for installation on various Linux systems are also available.

Setup By default the Mongoose Adapter will attempt to connect to MongoDB as the current user and create a new database using the project name. You can override these options when configuring the Mongoose Adapter.

TODO Replace with Keystone Next Figure out what to do with the .env in the browser