Skip to content

CMU-17-356/cmu-17-356-final-project-s23-stylelabz

Repository files navigation

Open in Codespaces

dronut-starter

In order to get ready to write productive code, complete the following steps during Sprint 0:

Repository Setup

  1. Create a new team and GitHub repository for your project using GitHub classroom. Your associated cmu email should show up in a listing and you can link your GitHub account. Subsequent members should choose to join an existing team using the same link. You may want to name your repository something like foobarbaz, which will end up as dronuts-2023-foobarbaz, aka your $respository_name.

We're ok with you keeping your project public, but you can make it private if you so desire. Don't forget to add .gitignore and `License** files!

  1. In addition, you should setup any tools needed for collaboration, issue tracking and project managment; Slack, Jira, GitHub Issues, ZenHub, Trello, whatever it is your team would like to use.

If you're new to Git and GitHub, we highly recommend reading the GitHub Documentation.

Github Actions

  1. Enable Github Actions. To do this, these steps can be followed.

Initialize NodeJS/NPM

  1. If you haven't already, install NodeJS and NPM on your computer.

  2. Initialize your repository for NPM by running npm init. This will generate a package.json file in your repository.

Choose a Web Framework and Install It

Within the NodeJS runtime, there a many frameworks for creating server applications. For the purposes of this assignment, there are two options you should consider:

  • Option 1: Express
    The Express Framework is a general-purpose web development framework with widespread adoption.

  • Option 2: Fastify
    The Fastify Framework is a low overhead web framework built for Node.js.

As a deliverable of Sprint 0, you will be asked to compare these frameworks. You should familiarize yourself with both projects in order to justify your decision. Once the decision is made, install it in your groups repository.

QA/Helpful Tools

  1. You should install a linter for your repository, to help manage code style. We highly recommend eslint or tslint if you decide to use typescript.

To go a little further, we can use eslint-watch to automatically lint while we're programming:

Success Condition:

$ npm run lint (## which is calling esw -w src test)
> ✓ Clean (10:12:27 AM)
  1. Because NodeJS projects have many dependencies, it is massively beneficial to use a tool to detect dependency updates and alert you as to potential vulnerabilities. Normally, we would recommend using a SaaS tool like GreenKeeper or requires.io. However, if you're repository is private, these tools require payment. If that's the case, you should install npm-check.

    Success Condition:

    $ npm-check
    > ❤️  Your modules look amazing. Keep up the great work. ❤️
    
  2. You should setup a test framework within your application to help with later test-driven development. We'd suggest Jest (especially for React development). Another option is to go with the Mocha framework along with Chai. Once installed, write a single test, which doesn't actually test anything (besides that your tests run).

    Success Condition:

    $ npm run test
    > PASS test/routes.test.js
    > GET /
    > ✓ should render properly (853ms)
    > GET /list
    > ✓ should render properly with valid parameters (48ms)
    > ✓ should error without a valid parameter (29ms)
    > GET /404
    > ✓ should return 404 for non-existent URLs (61ms)
    > ...
    
  3. Verify that the above tools and targets can be executed by Github Actions.

  4. Document the above tools in your README. Also update this boilerplate once it's no longer needed.

Docker

  1. Although Docker should already be configured (see Dockerfile and docker-compose.yml) as necessary, you may need to install the Docker Daemon on your machine to properly complete the assignment. Read the get-started guide for downloading Docker locally. If you're on a Linux OS, starting here would be more helpful. MAKE sure you do not install docker via snap. Snap's version of docker is outdated