Skip to content

codidact/landing-page

Repository files navigation

codidact/landing-page

The Codidact project landing page. It should contain a high-level overview of what the Codidact project is about, as well as references to resources such as the Wiki, Meta, and chat.

This site is live at https://codidact.org. A staging environment is available at https://codidact.github.io/landing-page (deployed via GitHub Pages based on the gh-pages branch).

Setting up your local development environment

  • Ensure node and npm are installed locally (nvm recommended).
  • Set node version to 16.14.0. You can install it using nvm install 16.14.0, and running nvm use 16.14.0 to use it in the project.
  • Run npm install to install project dependencies.
  • Run npm run start to start the front-end. This can be viewed by navigating to localhost:3000 in your browser.

Build outputs are part of the repo

After you make changes, build:

npm run build

This should make changes in dist. Include those in your commit.

Linting

Whilst CI tools will be used at a later date, before submitting a PR ensure your code is linted by running npm run lint. Any submitted PRs will be rejected if linting does not pass.

  • All formatting (except JS) is handled by Prettier (we recommend installing an auto-formatter for your IDE). The configuration is located in .prettierrc.
  • JS formatting and linting is handled by ESLint. JSON config resides in .eslintrc (to be added).
  • CSS linting handled by stylelint. JSON config in .stylelintrc.

Copying

MIT license applies to source code. It does not apply to assets under dist/assets/img/, particulary not to those within dist/assets/img/3rd-party/. Same applies to src/img/.