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.
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
- π 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.
- A retro-futuristic in-browser terminal allowing visitors to run commands (
- π₯ 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.
- Comprehensive JSON-LD Structured Data Schema graphs (
- β‘ Bun-Native Toolchain:
- Zero package bloat, lightning-fast dependency management, and production bundles compiled in ~1 second.
This repository is optimized for Bun.
Ensure you have Bun installed:
curl -fsSL https://bun.sh/install | bashClone the repository and install dependencies:
git clone https://github.com/PotenFYR-Studios/potenfyr-web.git
cd potenfyr-web
bun installStart the local development server with Hot Module Replacement:
bun run devManually sync latest repository metadata from GitHub and Modrinth:
bun run sync:github# Verify TypeScript types
bun run typecheck
# Pre-sync and build optimized production bundle
bun run buildThis site is deployed to GitHub Pages at: π https://potenfyr-studios.github.io/potenfyr-web/
The automated deployment pipeline (.github/workflows/deploy.yml) handles:
- Push to main: Automatically builds and deploys the production bundle to the
gh-pagesbranch. - Scheduled 6-Hour Cron (
0 */6 * * *): Rebuilds the site periodically to auto-sync new repositories, stars, and Modrinth download statistics without requiring manual commits.
When ready to link a custom domain (e.g., potenfyr.in):
- Point your DNS records (A/CNAME) to GitHub Pages IPs (
185.199.108.153, etc.). - In GitHub repository settings, go to Settings > Pages > Custom domain and enter your domain name.
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.