A native desktop workbench for AWS SQS and SQS‑compatible queues.
Browse, inspect, send and manage your queues from a fast local app — no browser tab, no AWS console.
SQSee is a single‑user desktop application that gives you a focused, keyboard‑friendly UI for working with Amazon SQS — and any SQS‑compatible service such as ElasticMQ or LocalStack. It runs locally as a real native app (built with NativePHP / Electron), keeps your data on your machine, and encrypts your AWS credentials at rest.
Note
SQSee is a desktop app, not a hosted web service. There is no server to deploy and no account to create — you connect directly to your own queues.
- 🔌 Connection profiles — save multiple connections (AWS, ElasticMQ, LocalStack) and open each in its own tab. Credentials are encrypted locally.
- 📊 Queue dashboard — see all queues with live message counts, hide empty queues, and sort by name or backlog.
- ✉️ Message workbench — send, receive, peek and inspect messages, including attributes and bodies.
- 🧩 Message templates — save reusable message payloads and send them in one click.
- 🛠️ Queue management — create, purge and delete queues straight from the app.
- 🛡️ Production guardrails — flag a profile as production to get extra confirmation before destructive actions.
- 📝 Audit log — a local record of the actions you perform.
- 🎨 Native niceties — light/dark/system theme, default region, global keyboard shortcuts, and a proper application menu.
| Layer | Technology |
|---|---|
| Desktop runtime | NativePHP (Electron) |
| Backend | Laravel 13, PHP 8.5 |
| UI | Livewire 4 + Flux UI Pro + Tailwind CSS 4 |
| AWS | AWS SDK for PHP (SQS) |
| Quality | Pest, Larastan, Laravel Pint |
SQSee uses Flux UI Pro, a commercial component library. Its source code is
not included in this repository (it lives in the git‑ignored vendor/ directory). To install
dependencies and build the app yourself, you need your own Flux Pro license, configured via an
auth.json file (which is git‑ignored and must never be committed):
{
"http-basic": {
"composer.fluxui.dev": {
"username": "you@example.com",
"password": "your-flux-pro-license-key"
}
}
}Without a Flux Pro license, composer install will fail on the livewire/flux-pro package. This repo
is published as a source‑available showcase of how the app is built; it is not a turnkey package
for users without a Flux Pro license.
- PHP 8.5+
- Node.js 20+ and npm
- Composer
- A Flux UI Pro license (see above)
git clone https://github.com/<your-username>/sqsee.git
cd sqsee
# Add your Flux Pro credentials to auth.json first (see section above), then:
composer setup # install deps, create .env, generate key, build assets
# The Electron scaffold (nativephp/) is not tracked in git — generate it once:
php artisan native:installcomposer native:dev # starts NativePHP (Electron) + Vite togetherTo prepare the local database for the desktop runtime:
php artisan native:migrate # or native:migrate:fresh to resetphp artisan native:buildcomposer lint # Laravel Pint (code style)
composer phpstan # Larastan static analysis (level 6)
composer test # lint + phpstan + full test suite
php artisan test --parallel # tests only
php artisan test --compact --filter=Name # a focused subsetTests are written with Pest and run against an in‑memory SQLite database, so no extra setup is needed.
Issues and pull requests are welcome. Please run composer test before opening a PR so that style,
static analysis and tests all pass. (Note that building the UI locally requires a Flux Pro license.)
SQSee's own source code is released under the MIT License.
This project depends on third‑party software that is not covered by the MIT license and carries its own terms — most notably Flux UI Pro, which is commercial and must be licensed separately. The MIT license applies only to the code in this repository, not to any bundled or referenced dependencies.