Link Search Menu Expand Document

Getting Started

The application is in early-stage development, so we must appologize—there are some cumbersome manual steps that will soon be unecessary.

Setup a MongoDB cloud (Atlas) Account and Database

No worries. For now, you can get pretty far with the free teer. Here’s how…

Create a MongoDB cloud (Atlas) account

  • Navigate to https://www.mongodb.com/cloud/atlas
  • Click Start free.
  • Click Sign up with Google (or your preferred way).

Create a cluster for your databases

  • Click Build a Cluster (free)
  • Choose AWS (for example)
  • Choose Oregon us-west-2 (for example) mongodb-atlas-create-starter-cluster.png
  • Click Create Cluster mongodb-atlas-create-cluster.png

Setup Network and User Access.

Network

  • Click (on the left), Network Access
  • Click Add IP Address
  • Select ALLOW ACCESS FROM ANYWHERE and Confirm

User

  • Click Database Access at the left and the click Add New Database User
  • Name the user admin
  • Choose password auth and Read and Write to any database

mongodb-atlas-add-db-user.png

Create databases for Preview and Production

  • Create an empty databse called rm_preview
  • Create another empty database called rm_production

Manually load data

Unfortunately, this is where you have to do manual loading of the databse because the app is not mature enough yet. The best way to load content into the rm_preview database is by using the MongoDB for VS Code extension and running the following playground script: ./mongodb-playgrounds/legacy-scripts/site-data.mongodb. Feel free to copy the script and customize it to suit your own site. To run this script, you will first need to press CTRL + SHIFT + P in VS Code, and the type “MongoDB” to bring up MongoDB commands. Choose Connect MongoDB and enter the URL connection string for your personal Atlas cluster and rm_preview database.

TO DO: Provide better documentation on how to use the MongoDB extension (or blog it and point to the blog post) TO DO: Consider developing a starter-content script specifically for demoing the system.

Setup a Vercel account

Next, you’ll need to setup a Vercel account and configure it so that when you deploy to your GitHub repository, it automatically builds and deploys your site.

TO DO: We need to work this whole process out and document it (from forking the code and on)