Skip to content

Preponderous-Software/preponderous-dot-org

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

36 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Preponderous Software Website

Description

The Preponderous Software website is a Next.js web application that serves as the public face of Preponderous Software. It showcases the projects — free, source-available games, simulations, and libraries — and links out to their source on GitHub. Built with React and Material UI, it mirrors the structure of the Dan's Plugins Community website.

Installation

First Time Installation

  1. Ensure Node.js (v18 or later) is installed on your machine.
  2. Clone this repository: git clone https://github.com/Preponderous-Software/preponderous-dot-org.git
  3. Install dependencies:
    npm install
  4. Build the project:
    npm run build
  5. Start the server:
    npm run start

The site will be available at http://localhost:3000.

Development Server

For local development with hot-reloading:

npm run dev

Usage

Documentation

Support

Experiencing a bug?

Please file a bug report here.

Contributing

See CONTRIBUTING.md.

Testing

Lint

npm run lint

If you see no errors, the lint check has passed.

Unit Tests

The site uses Vitest for unit tests. Run the suite with:

npm test

Test files live in the __tests__/ directory. If all tests pass, the suite has succeeded.

Technologies Used

📄 License

This project is licensed under the Preponderous Non-Commercial License (Preponderous-NC). It is free to use, modify, and self-host for non-commercial purposes, but commercial use requires a separate license.

Disclaimer: Preponderous Software is not a legal entity. All rights to works published under this license are reserved by the copyright holder, Daniel McCoy Stephenson.

Full license text: https://github.com/Preponderous-Software/preponderous-nc-license/blob/main/LICENSE.md

Project Status

This project is in active development. It has been redesigned from its original Spring Boot + Thymeleaf implementation to the Next.js stack described above.

About

This is a Spring Boot application for the Preponderous Software website, built with Java 21, Gradle, and Docker support.

Resources

License

Contributing

Stars

Watchers

Forks

Contributors