pokeapi.co
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.
Getting Started
Prerequisities
- 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
Installation
cd pokeapi.co
to go into the project root.npm install
to install project dependencies.
Running locally
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.
Building for production
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.
Contributing
Fork the project
- 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.
Make the change
- 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.
Test the change
If possible, test any visual changes in all latest versions of common browsers, on both desktop and mobile.
Push it
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.