Skip to content

soloinovator/nodejs.org

This branch is 1258 commits behind nodejs/nodejs.org:main.

Folders and files

NameName
Last commit message
Last commit date

Latest commit

0f393a7 · Jul 30, 2023
Jul 30, 2023
Jul 2, 2023
Jul 30, 2023
Jul 6, 2023
Jul 30, 2023
Jul 26, 2023
Jul 17, 2023
Jul 17, 2023
Jul 17, 2023
Jul 7, 2023
Jul 20, 2023
Jul 21, 2023
Jul 19, 2023
Jul 2, 2023
Jul 13, 2023
Jul 4, 2023
Jul 17, 2023
May 4, 2023
Mar 8, 2023
Jul 30, 2023
Jul 21, 2023
Aug 15, 2019
Jul 30, 2023
Jul 22, 2023
Mar 8, 2023
Jul 30, 2023
Jul 15, 2023
Jul 15, 2023
May 19, 2023
Jul 15, 2023
May 19, 2023
Apr 1, 2023
Jul 26, 2023
Jul 12, 2023
Jul 30, 2023
Jul 12, 2023
Aug 10, 2016
Jul 12, 2023
Jul 10, 2023
Apr 1, 2023
Jun 27, 2023
Jul 30, 2023
May 4, 2023
Jun 27, 2023
Jul 10, 2023
Jun 27, 2023
Jul 4, 2023
Jul 19, 2023
Jul 2, 2023
Jul 7, 2023
Jul 2, 2023
Jun 27, 2023
Jun 27, 2023
May 31, 2023
Jul 13, 2023
Jul 23, 2023
Jul 30, 2023
Jun 27, 2023
Jul 19, 2023
Jun 27, 2023
Jul 30, 2023

Repository files navigation


Node.js Website built using Next.js with TypeScript, SCSS and MDXv2

MIT License Crowdin Badge Powered by Vercel
Build and Analysis Checks

What is this repo?

Nodejs.org by the OpenJS Foundation is the official website for the Node.js® JavaScript runtime. This repo is the source code for the website. It is built using Next.js, a React Framework.

Quick-Start Locally

npm ci
npx turbo serve

# listening at localhost:3000

Structure of this Repository

  • Page templates are in /layouts
  • Global styles are in /styles
  • Public files are in /public
  • i18n configuration is on i18n/config.json
  • Global static files are in /public/static
    • Legacy static files are in /public/static/legacy
  • All content is in /pages
    • Initial development usually happens in English: /pages/en
    • /i18n/locales/{{locale}}.json is where global localization information lives.
    • All content is in Markdown and is per locale.
    • The top of each Markdown file is a block of YAML (Frontmatter) for page-specific localization information passed to various templates.
    • The bulk of the Markdown content for each page is referenced as {children} on their respective JSX Layout (layouts/)

Contributing

This project adopts the Node.js Code of Conduct.

Any person who wants to contribute to the Website is welcome! Please read Contribution Guidelines and see the Figma Design to understand better the structure of this repository.

To translate content into other languages

If you want to help translate to other languages or improve existing translations, it is optional to work from GitHub. You can and should do it through Crowdin; this is the correct workflow.

Crowdin is an online tool that facilitates the user experience for the translator; here is more information:

Website translations are handled via Crowdin.

To help with localization, please read the Translation guide.

Deployment

Full setup is in https://github.com/nodejs/build/tree/master/ansible/www-standalone minus secrets and certificates. The webhook is set up on GitHub for this project and talks to a small Node server on the host, which does the work. See the github-webhook package for this.

Relevant Links

Code of Conduct

Contribution Guidelines

Collaborator Guide

Figma Design

Content vs Code

Dependency Pinning

About

The Node.js website.

Resources

License

Code of conduct

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • TypeScript 45.6%
  • JavaScript 24.1%
  • SCSS 18.1%
  • MDX 12.0%
  • Other 0.2%