mre-fog / tmobile-isp-clientz

T-Mobile ISP Client

T-Mobile's trashcan web client is...garbage, so I'm building my own with SvelteKit. Feel free to use it or contribute!

Currently implemented:

• overview page w/ live updating (refreshes every 5s)
• list of device information

Running the app

Docker

The easiest way to setup and run the app with minimal development knowledge is to use Docker. Follow the installation instructions from the website, and then run:

docker-compose up

You can view the app on http://localhost:33201, which is set according to a default value for PORT=33201 since port 3000 tends to conflict with too many other things.

To run on a different port, set the PORT environment variable or set it in .env. By default, this will pull the tagged latest image from Docker Hub. To override this, set the TAG environment variable or modify it in .env.

Developing

Prerequisites

Clone the project, then install dependencies with npm install.

Dev Server

To start the dev server (with live reloading and hot module swapping), run:

npm run dev -- --host

# or start the server and open the app in a new browser tab
npm run dev -- --open

Building

This app uses the node adapter to enable server side rendering and reverse proxying to avoid CORS issues. Build for production with:

npm run build

To build the docker image, run

docker-compose build

You can preview the built app with npm run preview, regardless of whether you installed an adapter. This should not be used to serve your app in production.

To run in production, run node ./build, or docker-compose up as referenced previously.

Screenshots

Desktop

Mobile