This repository contains the source code and documentation for pokeapi.co. This website is built on React-Static, a static site generator similar to Gatsby, except unopinionated and with less magic.
- Git
- Node: 10.11.0 or greater
- A GitHub fork of the repo (for any contributions)
- A clone of the pokeapi.co repo on your local machine
cd pokeapi.co
to go into the project root.npm install
to install project dependencies.
npm run start
to start the hot-reloading development server (powered by React-Static).- Go to
http://localhost:3000
to view the site in your browser.
npm run build
to build the production site.npm run serve
to serve the production version of the site on a local test server.
Production files are located in the dist
directory.
- Fork the project to your own GitHub profile.
- Clone the forked repository onto your local machine.
git remote add upstream https://github.com/PokeAPI/pokeapi.co
to create a remote handle to the upstream repo.git pull upstream master
to ensure you have the latest main code.git checkout -b branch-name
(replacing branch-name with a suitable name) to create a branch for your changes.
- Follow the "Running locally" instructions.
- Save the files and check results in the browser.
Changes to React components in /src
will hot-reload. If modifying the /alerts.json
file or files in the /src/docs/
directory, you will need to restart the dev server before changes will be visible.
If possible, test any visual changes in all latest versions of common browsers, on both desktop and mobile.
git add -A
to stage your changed files.git commit -m "My message"
(replacing My message with a commit message, such as "Fix header logo on Android") to commit your changes. While not critically important, try to follow the guidelines in How to Write a Git Commit Message.git push my-fork-name branch-name
to push your changes to your own GitHub repository.- Go to the pokeapi.co GitHub repo and you should see your recently pushed branches.
- Follow GitHub's instructions to submit a pull request.
- Describe the changes you made in the body of the PR. If possible, include screenshots of visual changes.