Skip to content

GODrums/BetterFloat

Repository files navigation

BetterFloat

GitHub package.json dynamic Install and Build GitHub repo size GitHub commit activity (branch) GitHub license

Chrome Web Store Firefox add-ons

🤝 Community / Support

We maintain a very active Discord server, where you can share your snipes, ask questions, report bugs, or suggest new features. Join here:

Discord

📄 Highlights

Currently supports CSFloat.com, Skinport.com and Skinbid.com, but more sites are coming soon!

  • Display Buff prices (buy order + listings) for every item
  • Price difference to Buff at first glance next to the price tag
  • Accurate sticker price calculation (%sp) with gradual coloring
  • CSFloat: Auto-refresh in the "Newest Items"
  • CSFloat: See the listing age of an item
  • Skinport: Automatically check the checkboxes in the cart for faster buying
  • Skinport: Multiple currency conversion options
  • More coming soon!

Services

Chrome Web Store

Chrome Web Store Chrome Web Store Users Chrome Web Store Chrome Web Store

Mozillla Add-on

Mozilla Add-on Mozilla Add-on Users Mozilla Add-on Downloads

Status

Rums.dev Status

Troubleshooting on Mozilla Firefox

In some cases, Firefox does not grant extensions the necessary permissions automatically. This can be fixed by following these steps:

  1. Open the BetterFloat popup by clicking on the icon in the toolbar
  2. Look for a warning symbol in the top bar of the popup
  3. Click on the warning symbol and grant the necessary permissions in the newly opened popup of your browser
  4. Open the BetterFloat popup again and check if the warning symbol is gone
  5. If the warning symbol is still there, please report this issue in our Discord server

⌨️ Development

💻 The Tech Stack

Limitations of self-building

Due to the nature of the extension, some features are not available when building the extension yourself. This includes the pricing service and the OCO-feature. If you still want to use these features, please set up your own servers for it or use the official extension from the Chrome Web Store or Mozilla Add-on Store.

Installation

Prerequisites:

  • Node.js >=18.16.0
  • pnpm >=8.15.0 or npm >=9.5.0
  • tsc >=4.7.0

Prepare your local setup via the following command:

pnpm install
# copy the example env file
cp example.env .env
# fill in the required values. To exit VIM use ':wq'
vim .env

Building

Build the extension in development or production mode:

# development mode (Chrome or Firefox)
pnpm dev
pnpm dev:firefox
# production mode (Chrome or Firefox)
pnpm build
pnpm build:firefox

When working with multiple version, the build process may benefit from clean builds. This can be achieved by running the following command before building:

# careful, this will delete the build folder
pnpm clean

Loading

The built extension will be located in the build folder. For each created subversion (browser and manifest version), there will be a seperate subfolder. Load that folder as unpacked extension in your browser or pack it first and then load the packed version

Chrome:

  • Go to chrome://extensions or about:addons and enable developer mode
  • Click on "Load unpacked" and select the build/{version} folder

Firefox:

  • Go to about:debugging#/runtime/this-firefox
  • Click on "Load Temporary Add-on" and select the build/{version}/manifest.json file

Contributing

To contribute to this project, create your own fork of the repository and submit a pull request. Please follow the conventional commits specification (or an equivalent one) and make sure to format your code with Prettier. This projects supports the following commands to control code quality:

pnpm lint  # runs eslint
pnpm prettier  # currently not available, format with CTRL+SHIFT+F

Make sure to test your changes extensively on both browsers and include relevant results in your pull request.

⚠️ Disclaimer

BetterFloat is developed independently, and is not officially endorsed by or affiliated with CSFloat Inc., Skinport GmbH, or SkinBid ApS in any way. If you are a legal representative of the aforementioned companies and would like this project to be taken down, please contact me directly at legal@rums.dev.

Built with 🖤 in Munich.