# Welcome to the BridgeLink Web Administrator Beta

Thank you for joining the BridgeLink Web Administrator public beta.

BridgeLink Web Administrator is a modern, browser-based admin interface for
the BridgeLink integration engine. It is designed to replace the legacy Java
Swing administrator with full feature parity and a faster, more responsive
experience — no Java runtime, no per-workstation install of the admin client,
and a UI that works on any modern browser.

---

## Beta status

You are running pre-release software. A few things to keep in mind:

- **Frequent updates during the beta.** New builds are published regularly
  while we gather feedback and ship fixes. We recommend pinning to a specific
  image tag or artifact version (see [INSTALL-DOCKER.md](./INSTALL-DOCKER.md)
  or [INSTALL-TARBALL.md](./INSTALL-TARBALL.md)) so you control when you
  pick up changes.
- **Your feedback shapes the product.** Bug reports, papercuts, and feature
  suggestions all help us prioritize what to ship before general
  availability.
- **The legacy Java admin remains available.** If you need to drop back to
  it at any point, your BridgeLink server still accepts it — switching is
  non-destructive.
- **Beta agreement applies.** Your continued use is governed by the beta
  agreement you signed during registration.

---

## Getting installed

Pick the format that fits your environment:

| Format                        | Best for                                                      | See                                        |
| ----------------------------- | ------------------------------------------------------------- | ------------------------------------------ |
| **Docker image**              | Linux servers, multi-user deployments                         | [INSTALL-DOCKER.md](./INSTALL-DOCKER.md)   |
| **Linux tarball** (`.tar.gz`) | Linux servers without Docker, or restrictive network policies | [INSTALL-TARBALL.md](./INSTALL-TARBALL.md) |
| **Windows zip** (`.zip`)      | Windows servers, single-user testing                          | [INSTALL-TARBALL.md](./INSTALL-TARBALL.md) |

Before installing, confirm your environment meets
[SYSTEM-REQUIREMENTS.md](./SYSTEM-REQUIREMENTS.md).

---

## Getting help and giving feedback

Two channels, both staffed by the BridgeLink team:

- **Slack — for questions, discussion, and quick help:**
  [bridgelink.innovarhealthcare.com](https://bridgelink.innovarhealthcare.com)

- **GitHub Issues — for bugs and feature requests:**
  [github.com/Innovar-Healthcare/BridgeLink-Webadmin](https://github.com/Innovar-Healthcare/BridgeLink-Webadmin)

### What to include in a bug report

Including these details speeds up our response significantly:

1. **Build identifier** — the image tag (e.g. `:20260511` or
   `:sha-b6a7884`) or the artifact filename if you installed the tarball or
   zip
2. **Browser and OS** — e.g. "Chrome 124 on Windows 11" or "Safari 17 on
   macOS 14"
3. **What you were trying to do** — one sentence is fine
4. **What happened vs. what you expected**
5. **Steps to reproduce** if you can isolate them
6. **Browser console errors** if you can copy them (open DevTools →
   Console)

Screenshots and short screen recordings are very welcome.

---

## What's next

1. Confirm the [system requirements](./SYSTEM-REQUIREMENTS.md) for your
   target environment
2. Install via [Docker](./INSTALL-DOCKER.md) or [tarball/zip](./INSTALL-TARBALL.md)
3. Log in with your existing BridgeLink credentials
4. Tell us what you find — good and bad
