Skip to content

oSTEM/conference-site

Repository files navigation

oSTEM Conference Site

Non-code (copy) edits

For most non-code changes, edits can be made in the GitHub interface.

You can edit the page (at src/pages/[conference year]/[page].mdx).

Development environment setup

These steps will get you set up with a development environment for the project. The development environment will let you preview changes as you edit and should be used for code changes. For text changes (e.g., changing text in an .mdx file), you can just use the GitHub web interface (see above).

Install NodeJS

First, if you haven't already, install Node.js. If in doubt, for MacOS use Homebrew (once installed, run brew install node in the terminal); and for Windows use scoop (once installed, run scoop install nodejs in PowerShell).

Clone the repository

If you're not experienced with cloning Git repositories, we recommend using GitHub Desktop. You can also use the Git: Clone command within VSCode.

Install project dependencies

This will install all of the JavaScript dependencies (such as React and TypeScript) for this project.

npm install

Starting the development server

First, run the development server:

npm run dev

Open http://localhost:3000 with your browser to see the result. Any edits you make will be reflected in real time (after you save the file).

Helpful reading

If you're new to React or NextJS, these might be some helpful resources:

Directory structure

src/pages

Files in this directory define pages for the site. For example, src/pages/foo.mdx would define the page at the /foo URL and src/pages/bar/spam.mdx would define a page at the /bar/spam URL. See the NextJS docs for more information about this.