Skip to content

Herobread/better-studres-v2

Repository files navigation

An open-source browser extension, that improves appearance of the St Andrews Student Resources, featuring a completely redesigned UI and UX, enhanced accessibility, and a range of new functionalities.

chrome web store mozilla addons

Better studres

Features

Completely overhauled UI and UX

  • dark mode
  • pinned links
  • command panel with search for visited folders
  • smooth navigation between pages
  • breadcrumbs in navigation

File Enhancements

  • file and folder download
  • code syntax highlighting
  • basic version tracking
  • file notes
  • file tags
  • "reading mode" for html

Customize

Use popup to change date display mode, icons, and UI elements visibility.

Tech Stack

  • vite
  • react
  • TypeScript
  • tailwind CSS
  • shadcn UI
  • tanstack query
  • nice-modal-react
  • react-syntax-highlighter

vite-web-extension template

How to Run in dev mode

  1. Install Dependencies

    bun install
  2. Start the Development Server

    chrome:

    bun run dev

    firefox:

    bun run dev:firefox

    This will automatically rebuild the extension to the dist/ directory.

  3. Refresh Extensions in browser

    After running the development server, refresh your extension(s) and the Studres page to see the changes.

How to build

chrome:
```bash
bun run build
```

firefox:
```bash
bun run build:firefox
```

Output will be stored in the dist/

Enjoy the improved StudRes experience!