freeCodeCampOS

How To Create A Course

Install freecodecamp-os in your project root:

npm install @freecodecamp/freecodecamp-os

Add a freecodecamp.conf.json file to your project root:

{
  "path": ".",
  "prepare": "echo 'prep'",
  "scripts": {
    "develop-course": "NODE_ENV=development node ./node_modules/@freecodecamp/freecodecamp-os/.freeCodeCamp/tooling/server.js",
    "run-course": "NODE_ENV=production node ./node_modules/@freecodecamp/freecodecamp-os/.freeCodeCamp/tooling/server.js",
    "test": {
      "functionName": "handleMessage",
      "arguments": [
        {
          "message": "Hello World!",
          "type": "info"
        }
      ]
    }
  },
  "workspace": {
    "previews": [
      {
        "open": true,
        "url": "http://localhost:8080",
        "showLoader": true,
        "timeout": 20000
      }
    ]
  },
  "bash": {
    ".bashrc": "./bash/.bashrc",
    "sourcerer.sh": "./bash/sourcerer.sh"
  },
  "client": {
    "assets": {
      "header": "./client/assets/fcc_primary_large.svg",
      "favicon": "./client/assets/fcc_primary_small.svg"
    },
    "landing": {
      "description": "Placeholder description",
      "faq-link": "#",
      "faq-text": "Link to FAQ related to course"
    }
  },
  "config": {
    "projects.json": "./config/projects.json",
    "state.json": "./config/state.json"
  },
  "curriculum": {
    "locales": {
      "english": "./curriculum/locales/english"
    }
  },
  "tooling": {
    "helpers": "./tooling/helpers.js"
  }
}

Add all the necessary files to your project (use this repo as a reference)

How this Works

This repo consists of:

.freeCodeCamp/ - the directory that is published to NPM
- client/ - SPA showcasing the curricula content
- tooling/ - directory containing Nodejs scripts to run a server serving the client
.logs/ - directory containing files with terminal log data
bash/ - directory for bash configuration
client/ - directory for assets used in .freeCodeCamp/client/
config/ - directory for project configuration and state
curriculum/ - directory for curriculum content
- locales/ - directory for different language versions of the curriculum
tooling/ - directory for Nodejs scripts integrated with .freeCodeCamp/tooling/ but specific to the curriculum

The course content served on the client is written in Markdown files. The lesson/project tests run on the Nodejs server are written in the same markdown files.

The freecodecamp.conf.json file is used to configure the course, and define the actions taken by the freeCodeCamp - Courses extension. The freecodecamp-os package version used should match the minor version used for the extension. This is configured in the .devcontainer/devcontainer.json file.

Joroovb/freeCodeCampOS

freeCodeCampOS

How To Create A Course

How this Works