Skip to content

r1c0n/gws

logo

Introducing Gamma Web Server πŸš€

A lightweight and fast web server written in Go.

All Contributors

gws license gws forks gws stars gws issues gws pull-requests

Alt

πŸ” File Content

These are what the different files / directories contain in this repository.

File/folder Description Directory
.github Contains GitHub related files, such as workflows. Yes
branding Contains Gamma artwork. Yes
docs Contains documentation for GWS. Yes
src Source code of Gamma Web Server. Yes
.all-contributorsrc All-Contributors bot configuration file No
.gitattributes Defines attribute rules for Git repository. No
.gitignore Defines what to not commit to Git. No
.markdownlint.json Markdownlint configuration file. No
.prettierignore Defines folders or files to not format in Prettier No
.prettierrc Prettier configuration file. No
CHANGELOG.md Contains automatically generated GWS Changelogs. No
CODE_OF_CONDUCT.md This contains the contributor covenant code of conduct. No
LICENSE The Gamma Web Server license. No
README.md Before asking questions, read this file. No
SECURITY.md Contains the security policy of Gamma, along with supported versions. No
gen_changelog.cmd Command file for generating changelogs in CHANGELOG.md No

✨ Features

  • Supports HTTP and HTTPS
  • Easy & quick setup
  • Easy to use configuration file

🚧 Build

Read our build documentation @ /docs/build.md to learn how to build Gamma Web Server.

πŸš€ Installation

Download the latest release from GitHub, or find the latest release on our website: https://www.gammaws.gq

πŸ“– Usage

To start Gamma Web Server, double click on the .exe file, or run it through the command-line.

.\gws.exe

To see your website, visit the link showed on the command-line below the product information. By default, the link is localhost.

βš™οΈ Configuration

Gamma Web Server uses a JSON configuration file to customize its behavior. You can specify the port, the document root & more in the configuration file. You can find an example config.json in the src/json directory. One will be generated when the project is built.

Here is an example of what the config.json should look like.

{
  "port": ":80",
  "tls_config": {
    "cert_file": "server.crt",
    "key_file": "server.key"
  },
  "static_dir": "public",
  "repo_config": {
    "version": "1.1.0",
    "author": "Official B",
    "product": "Gamma Web Server",
    "repository": "https://github.com/gamma-gws/gws"
  }
}

πŸ“„ License

Gamma Web Server is licensed under the GNU General Public License v3.0 - see the LICENSE file for details.

πŸ’ͺ Contributors

Thank you to the wonderful people below! (emoji key):

recon
recon

πŸ’» πŸ“– 🎨 πŸ’‘ πŸš‡ πŸ‘€ πŸ“¦
porokimun
porokimun

🎨
kimotpe
kimotpe

πŸ“¦
zauce
zauce

πŸ“¦

This project follows the all-contributors specification. Contributions of any kind welcome!


Don't forget to give a ⭐️ to Gamma Web Server! It's a great motivation booster.