Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/acquitelol/sparxmaths

The cutest Sparx Maths theming and bookwork bypass extension ~!
https://github.com/acquitelol/sparxmaths

auto-bookwork autobookwork azalea bookwork bookwork-bypass boookwork-code chrome chrome-extension chrome-extensions chromium chromium-extension extension homework sparx sparx-bookwork sparx-maths sparx-maths-solver sparx-solver sparxmaths sparxsolver

Last synced: about 22 hours ago
JSON representation

The cutest Sparx Maths theming and bookwork bypass extension ~!

Awesome Lists containing this project

README

        

# Azalea

## **The** ***cutest*** **SparxMaths bookwork-bypass extension for Chromium ~!**

### ✩ *If you like this project, consider giving it a star!* ✩

### ♡ **How to install:**

- Go to [**Releases**](https://github.com/acquitelol/azalea/releases/) > **[Latest](https://github.com/acquitelol/azalea/releases/latest)** or click on **[Azalea.zip](https://github.com/acquitelol/azalea/releases/latest/download/Azalea.zip)** to download the **compressed extension bundle** containing all the things to be injected into Sparx!



- Extract the ZIP to a folder onto your local file system.
- Open the **Manage Extensions** tab in your Chromium-based browser
- (This can be any browser ranging from `Chrome` to `Edge` to `Opera` to `Arc` to `Orion`).


- *(Enable* ***Developer Mode*** *if not enabled already.)*
- Click on **Load Unpacked**.
- Select the **Azalea-(version)** directory.


- **You're done!** Open/Refresh `Sparx` and the extension should be installed! :D

### ♡ **Features provided by the extension:**

- Adds a simple CSS property which **allows all text to be selectable**:

```css
:root {
--user-select-accessibility-setting: default !important;
}
```

- Provides access to **Themes** by going into **Menu > Settings** at the top right!
- Currently the **themes available** include:
- None (Default ✓), Pink, Purple, Blue, Aqua, Green, Creme, Dusk, Custom



- *Note:* ***Custom themes allow you to theme every colored variable available in Azalea, ranging from tints to regular colors to text colors. This uses the colors for `Pink` by default because I advocate for pink and believe it is the best color <3.***

- Stores **bookwork checks** and automatically selects them if possible (this is *on* by default, and can be disabled from **Menu > Bookwork**), otherwise shows you the most recent answers to choose the correct option yourself.

- *Note:* **You can manage your stored bookwork checks by going into ***Menu > Bookwork*** at the top right**


- Allows you to anonymize your username by setting it to **Rosie :3** by default (editable from **Menu > Settings**, off by default). This aims to make Sparx a place where you cannot be doxxed by showing a screenshot asking for help!


- Allows you to change the icon used in Sparx by providing an image URL! (editable from **Menu > Settings**, off by default).

### ♡ **Notes on bundling and updating:**

- The codebase **is minified and obfuscated into a bundle**, but this is simply done to reduce file size when installing. This means that **all of the source code is public** and the codebase is transformed into a bundle using GitHub Actions, available to view [here](https://github.com/acquitelol/azalea/actions).


- This ensures that the code is safe to use for everyone! If you don't trust me, the actions, or want to be extra sure, *which is perfectly fair enough*, **clone the repository and build the extension yourself**!


- Due to the limited nature of Manifest V3 Chrome Extensions, having an updater is *very* difficult and convoluted, due to Chrome's Storage APIs being too slow to load the code in time to yield React via exfiltration. As such, there is no way to update automatically. You must re-download Azalea from [releases](https://github.com/acquitelol/azalea) every time there is an update.

> If you have any questions, please [raise an issue](https://github.com/acquitelol/azalea/issues/new) :3

### ♡ **Contributing:**

- To contribute to this project, it's **really** simple!
- Fork **[this repository](https://github.com/acquitelol/azalea)**
- Clone the fork locally using:

```console
$ git clone https://github.com/[YOU]/[FORK]
```

- Open up the repository, and checkout a new branch:

```console
$ git checkout -b feature/meow
```

- Add your amazing feature(s) and **commit & push to the branch**:

```console
$ git commit -m 'Added cutest new feature! ;3'
$ git push origin feature/meow
```

- Create a **[pull request](https://github.com/acquitelol/azalea/pulls)** and wait for it to be reviewed
- ***You're done!*** **Thanks for your contribution! :D**

♡ Made by Rosie :3

Copyright © 2023 Rosie ([acquitelol](https://github.com/acquitelol))

```
All rights reserved.

The software provided is not affiliated with Sparx LTD, Sparx Maths, or Sparx Learning.

All software is provided for educational purposes only, and should not be used for unlawful or unethical modification of the Sparx Maths website.
```


⇡ Back to top️!