Skip to content

[WIP] Rewrites docs into Astro (Starlight)#7

Draft
Adammatthiesen wants to merge 37 commits into
faststats-dev:mainfrom
Adammatthiesen:astro
Draft

[WIP] Rewrites docs into Astro (Starlight)#7
Adammatthiesen wants to merge 37 commits into
faststats-dev:mainfrom
Adammatthiesen:astro

Conversation

@Adammatthiesen

Copy link
Copy Markdown

This pull request rewrites the project's configuration, build system, and documentation setup. It removes configuration files and workflows related to Bun, Oxlint, and Oxfmt, and migrates the final docker build process to use pnpm and Nginx. Additionally, it introduces new development and documentation files for Astro and Starlight, updates the Dockerfile, and adds VSCode recommendations and launch configurations.

TODOs:

  • Reconfigure Github Actions
  • Reconfigure Renovate
  • Reconfigure Project Linter (see notes)

Notes:

  • I'm not familiar with Oxlint and Oxfmt, or how they interact with Astro, i know there has been some work for them, but am not sure what the current state of that is. (Personally if your up for suggestions BiomeJS is a pretty nice linter that i use in all my projects)
  • .prototools is used by Moon's Proto a local runtime/"package manager" manager. prevents my CLI sessions from running unwanted version in projects
  • Repository has been moved from Bun to PNPM as Astro does not officially support BUN.
  • Docker built now uses static NGINX and exposes port 8080 instead of a full server instance thanks to Starlight usage.

- Simplified ContentPanel by removing API doc specific logic and styles.
- Updated content configuration to remove unused schemas and types, streamlining the docs collection.
- Added variable font imports for Geist and Geist Mono, and updated font styles in CSS.
feat: update tsconfig.json to support React JSX syntax

feat: add NodeDocCard component for displaying node documentation

feat: implement node preview components for various flow nodes

docs: create flow-nodes documentation with detailed descriptions and examples

docs: add overview and output-nodes documentation for chart editor

style: consolidate global styles into global.css for better organization
- Introduced background and logo images for OpenGraph sharing.
- Implemented route middleware to update OpenGraph meta tags dynamically.
- Created utility function to retrieve OpenGraph image paths based on page routes.
- Introduced new pages for Custom Metrics, Error Tracking, Feature Flags, and Installation.
- Added Migration Guide for upgrading from version 0.23.0 to 0.24.0.
- Included Obfuscation Mappings documentation for uploading ProGuard/R8 mappings.
- Created platform-specific integration guides for Bukkit, BungeeCord, Fabric, Hytale, Minestom, NeoForge, Nukkit, Sponge, and Velocity.
- Documented system properties for configuring FastStats behavior at runtime.
- Introduced consent and cookieless mode documentation.
- Added error tracking guidelines for browser and server errors.
- Documented automatic and custom event tracking.
- Explained feature flags usage in the browser.
- Provided instructions for identifying users and managing sessions.
- Created installation and setup guides for FastStats Web Analytics.
- Detailed JavaScript SDK usage and configuration.
- Added Nuxt integration instructions for FastStats Web Analytics.
- Documented React and Next.js integration with FastStats Web Analytics.
- Explained session replay functionality and configuration.
- Added sourcemaps upload instructions for better error tracking.
- Documented reporting of Core Web Vitals from the browser SDK.
@LuggaPugga

LuggaPugga commented Jul 7, 2026

Copy link
Copy Markdown
Member

Thanks for the PR!
I'll review it in just a minute.

Just a comment on the formatter/linter thing:

We used Biome for a really long time inside the monorepo, but the memory usage of the VS Code extension was sometimes going over 20 GB 😅
That's why I made the switch to the Oxc tools.

According to oxc-project/oxc#19715, there is no Astro support yet, and since this repository is a lot smaller than our internal monorepo, it should be fine to use it again
The plugin is just not bundled in by default, so it should be fine to use. I'll just experiment with it a little

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants