Skip to content

Repository files navigation

PotenFYR Studios banner

Typing SVG

Website Discord Modrinth Email GitHub Workflow


⚑ Overview

Welcome to the official PotenFYR Studios web repository. This platform serves as the central showcase, interactive catalog, telemetry deck, and software portal for PotenFYR Studios: engineering Minecraft modding systems, universal container hosting eggs, automated PR security tooling, and high-concurrency cloud infrastructure.

The website is engineered for speed and immersion: powered by Bun, built with Vite + React 18 + TypeScript, styled with Tailwind CSS, and enhanced with modern animations and real-time auto-sync telemetry.


πŸ“Š Live Studio Telemetry & Stats

Public Repositories Total Community Stars Verified Modrinth Downloads Ecosystem Status
Repos Stars Downloads Status
  POTENFYR STUDIOS // TELEMETRY BENCHMARK
  -------------------------------------------------------------
  [βœ“] Node Status       : Edge CDN // Systems Operational
  [βœ“] Build Runtime     : Bun v1.4.0 (Vite Compilation in ~1.08s)
  [βœ“] Auto-Sync Engine  : GitHub REST API + Modrinth v2 API
  [βœ“] Cache Layer       : Stale-While-Revalidate (15m TTL LocalStorage)
  [βœ“] Security Protocol : APICordon Automated Pull-Request Scans

✨ Flagship Platform Features

  • πŸ”„ Autonomous Auto-Sync Engine:
    • Automatically fetches all public repositories, stargazers, forks, and release telemetry from the GitHub REST API.
    • Queries Modrinth v2 API for verified live download counts (AuthCore: 2,000+, Statfyr, OneJumpAllJump).
    • Safe 15-minute caching mechanism prevents unauthenticated rate limits.
    • Any future repository created under the organization automatically appears in the software catalog.
  • πŸ’» Interactive Command Terminal:
    • A retro-futuristic in-browser terminal allowing visitors to run commands (status, projects, eggs, stack, sync, help) with zero page-jumping.
  • πŸ₯š Universal Egg Infrastructure Matrix:
    • Interactive specification and compatibility explorer showcasing our container eggs across Pterodactyl, Pelican, Feather Panel, PufferPanel, Docker, and Kubernetes.
  • 🌐 World-Class Global SEO:
    • Comprehensive JSON-LD Structured Data Schema graphs (Organization, WebSite, SoftwareApplication).
    • Google and Bing rich snippets for software packages, canonical links, prioritized sitemap, and OpenGraph/Twitter cards.
  • ⚑ Bun-Native Toolchain:
    • Zero package bloat, lightning-fast dependency management, and production bundles compiled in ~1 second.

πŸ› οΈ Technology Stack

Bun React TypeScript Vite Tailwind CSS Framer Motion GitHub Actions


πŸš€ Quick Start & Local Development

This repository is optimized for Bun.

Prerequisites

Ensure you have Bun installed:

curl -fsSL https://bun.sh/install | bash

Installation

Clone the repository and install dependencies:

git clone https://github.com/PotenFYR-Studios/potenfyr-web.git
cd potenfyr-web
bun install

Development Server

Start the local development server with Hot Module Replacement:

bun run dev

Run Auto-Sync Standalone

Manually sync latest repository metadata from GitHub and Modrinth:

bun run sync:github

Production Build & Typecheck

# Verify TypeScript types
bun run typecheck

# Pre-sync and build optimized production bundle
bun run build

🌐 Deployment & Hosting Configuration

This site is deployed to GitHub Pages at: πŸ‘‰ https://potenfyr-studios.github.io/potenfyr-web/

GitHub Actions Workflow

The automated deployment pipeline (.github/workflows/deploy.yml) handles:

  1. Push to main: Automatically builds and deploys the production bundle to the gh-pages branch.
  2. Scheduled 6-Hour Cron (0 */6 * * *): Rebuilds the site periodically to auto-sync new repositories, stars, and Modrinth download statistics without requiring manual commits.

Custom Domain Setup (Optional)

When ready to link a custom domain (e.g., potenfyr.in):

  1. Point your DNS records (A/CNAME) to GitHub Pages IPs (185.199.108.153, etc.).
  2. In GitHub repository settings, go to Settings > Pages > Custom domain and enter your domain name.

🀝 Community & Support

GitHub Website Community Support Modrinth


πŸ“œ License

This project is licensed under the Apache License 2.0 with the Commons Clause: see the LICENSE file for details. Free to fork, modify, use, and build products or services around it - but the software itself may not be sold as a paid product.


Built by PotenFYR Studios Β· potenfyr.in Β· Part of the PotenFYR Studios open-source ecosystem.

footer banner

About

Official Website for PotenFYR Studios

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Contributors

Languages