Skip to content

Latest commit

 

History

History
142 lines (110 loc) · 7.75 KB

README.md

File metadata and controls

142 lines (110 loc) · 7.75 KB

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.