memowise

A flashcard app running Next.js, Tailwind CSS and MongoDB Atlas.

This project is for demonstration purposes only.

View demo | Read the article

Features

• 👉 Navigate flashcard sets by topic and sub-topic
• 👀 View flashcard listing for any set
• ✅ Test your knowledge with a multiple-choice quiz

Signed-in users get access to the following.

• ✏️ Create and manage your own flashcard set
• 🔗 Link/Unlink any flashcard set to your account
• 📓 Study flashcards (based on SM-2 algorithm)

Technology

• Next.js
• Next-Auth
• Tailwind CSS
• MongoDB Atlas

Development

Prerequisites

• Node >= v14.17.6.
• Yarn v1.22.11 (optional)

Install

First, fork the project to your GitHub account.

$ git clone https://github.com/[your_github_username]/memowise.git
$ cd memowise
$ yarn # or npm i

Configure

Copy .env.example to .env. Then, set the values as described below.

MongoDB

Memowise uses MongoDB. Provide connection credentials to the following variables.

• DB_USER - db user name
• DB_PASS - db user's password
• DB_NAME - db name
• DB_URI - the connection string to db

Next-Auth

• NEXTAUTH_URL - for local dev, use http://localhost:3000
• SECRET - any value

GitHub

Currently, Memowise only uses GitHub for authentication. Assign GitHub OAuth credentials to the following variables.

• GITHUB_ID
• GITHUB_SECRET

Database

Memowise includes a simple cli to load default data.

Usage

$ yarn db --help

  Usage: yarn db [options]

  Options:
    --user=<id>   Set user's 'decks' field
    --data        Load topics, sub-topics and decks
    -h, --help

Note:

1. --data drops all collections and reloads data from ./src/data/seed.js.
2. --user assigns 3 decks to user.linked and 3 decks to user.created

Follow these steps:

1. Load the database via: yarn db --data
2. Run the application and sign-in via GitHub
3. Retrieve your newly created user id in MongoDB
4. Setup default linked/created decks for user id via: yarn db --user=<id>

Run the app

# development
$ yarn dev

or...

# build & run
$ yarn build
$ yarn start

Then, navigate to http://localhost:3000.

Author

• David Valles

License

MIT License