gradebook

Please tag @edx/educator-neem on any PRs or issues.

Introduction

The front-end of our editable Gradebook feature.

Usage

To install gradebook into your project:

npm i --save @edx/gradebook

Running the UI Standalone

After cloning the repository, run make up-detached in the gradebook directory - this will build and start the gradebook web application in a docker container.

The web application runs on port 1991, so when you go to http://localhost:1991 you should see the UI.

If you don't, you can see the log messages for the docker container by executing make logs in the gradebook directory.

Note that make up-detached executes the npm run start script which will hot-reload JavaScript and Sass files changes, so you should (🤞) not need to do anything (other than wait) when making changes.

Configuring for local use in edx-platform

Assuming you've got the UI running at http://localhost:1991, you can configure the LMS in edx-platform to point to your local gradebook from the instructor dashboard by putting this settings in lms/env/private.py:

WRITABLE_GRADEBOOK_URL = 'http://localhost:1991'

Directory Structure

• config
  • Directory for webpack configurations
• public
  • Entry point for the single-page application - gradebook has a single index.html file
• src
  • components
    • Directory for presentational React components
  • containers
    • Directory for container React components
  • data
    • actions
      • Directory for Redux action creators
    • constants
    • reducers
      • Directory for Redux reducers

Authentication with backend API services

See the @edx/frontend-auth repo for information about securing routes in your application that require user authentication.