ChatBus HomePage

ChatBus HomePage is a Gatsby-based team homepage project that deploys to chatbus.github.io through GitHub Actions CI/CD.

What is ChatBus HomePage?

ChatBus HomePage is an open-source homepage built by the ChatBus team to study React and Gatsby. It takes a GitHub repository as its source and produces a static website deployed to GitHub Pages at https://chatbus.github.io. The stack consists of Gatsby, React, and Node.js 16.17.0+, with Yarn as the package manager. The project is maintained by three contributors — 도니 (jams777), 엘라 (thgml21004), and 첸첸 (CheonInJeong) — who handle environment setup, design and publishing, and front-end development plus testing.

Key Features

• Gatsby and React stack — Built with the Gatsby static site generator and React, with the initial source created by following the official Gatsby tutorial.
• Automated deployment via GitHub Actions — Merging a pull request into the main branch automatically triggers a build and deployment using the gatsby-gh-pages-action workflow.
• GitHub Pages hosting — The final static site is published to the chatbus.github.io repository and accessible at https://chatbus.github.io.
• Docker-based development environment — A prebuilt Docker image (jams777/chatbus_homepage_local) lets developers run the project without installing Node.js or Yarn; the container exposes ports 5001 and 8000.
• Yarn setup path — Developers can also install dependencies with classic Yarn (yarn install) if they have Node.js 16.17.0 or higher.
• MIT License — The project is released under the MIT open-source license.
• Issue and PR management — Bugs and features are tracked through GitHub Issues and pull requests, with contributor-specific badges in the README linking to open issue and PR counts.

Who is it for?

• Gatsby and React learners — can use the repository as a real-world example of a Gatsby site; the initial code was built by following the Gatsby tutorial, making it a study-friendly codebase.
• Small teams needing a homepage — can clone the repo, customize it, and rely on the built-in GitHub Actions workflow to publish changes to GitHub Pages automatically.
• Developers who want a containerized dev environment — can pull the provided Docker image and run the project without installing Node.js or Yarn locally.
• Open source contributors — can participate by filing issues, submitting pull requests, or extending the homepage; the README shows the current three maintainers and their roles.

What can you do with ChatBus HomePage?

• Build and deploy a team homepage — Push changes to the main branch via pull requests and let GitHub Actions rebuild and publish the site to chatbus.github.io.
• Set up a development environment — Either run yarn install or pull the Docker image jams777/chatbus_homepage_local and call start inside the container to launch the dev server.
• Learn CI/CD with Gatsby — Examine the GitHub Actions workflow files (main.yml, test.yml) to see how automated tests and deployment to GitHub Pages are configured.
• Track and manage contributions — Use the GitHub Issues and pull request workflows to organize work; the README even includes per-contributor badges linking to open issues and PRs.

How does ChatBus HomePage work?

The workflow is straightforward: after cloning the repository, set up the project with Yarn or Docker, then open pull requests against the main branch. Once a pull request is merged, a GitHub Action (based on gatsby-gh-pages-action) builds the Gatsby site and pushes it to the chatbus.github.io repository. The live page is then available at https://chatbus.github.io.

FAQ

Is ChatBus HomePage free to use?

Yes, the project is released under the MIT license, so it is free to use, modify, and distribute. It is an open-source repository on GitHub at chatbus/chatbus_homepage.

What technology stack does ChatBus HomePage use?

It is built with the Gatsby static site generator, which uses React for UI components. The initial source was created by following the official Gatsby tutorial. Package management is done with Yarn, and the project requires Node.js 16.17.0 or higher for the non-Docker setup.

How does ChatBus HomePage get deployed?

Deployment is automated with GitHub Actions. When a pull request is merged into the main branch, the gatsby-gh-pages-action workflow builds the site and pushes it to the chatbus.github.io repository. The live site is served from https://chatbus.github.io.

Can I run ChatBus HomePage without installing Node.js?

Yes, there is a Docker image named jams777/chatbus_homepage_local. You pull the image, run a container, and use the start command to launch the development environment. The container exposes ports 5001 and 8000.