Tally · Subscription Tracker

Tally is a lightweight, responsive web application designed to help you keep track of all your recurring subscriptions, visualize your monthly and yearly expenses, and discover potential savings by switching to alternative plans.

Description & Function

With the rise of subscription-based services for streaming, software, and utilities, it's easy to lose track of what you're paying for. Tally solves this by offering a unified dashboard where you can:

• Track Expenses: Log all your subscriptions along with their billing cycles (monthly or annual).
• Monitor Renewals: See at a glance which subscriptions are renewing soon and when.
• Find Savings: Tally automatically suggests alternative plans (e.g., ad-supported tiers or annual billing) for popular services to help you cut costs.
• Calculate Totals: Instantly view your true monthly and yearly financial commitment.

(Note: This is currently a prototype. Prices are illustrative examples, and data is not persisted between sessions.)

Installation & Local Development

This application consists of a single-page HTML frontend served by a lightweight Node.js Express backend.

Prerequisites

• Node.js (v18 or higher recommended)
• npm (Node Package Manager)

Steps to Run Locally

1. Clone the repository and navigate to the project directory.
2. Install the required Node.js dependencies:

   npm install

3. Start the local server:

   npm start

4. Open your browser and navigate to http://localhost:8080.

Deployment to Google Cloud Run

This project is fully configured to be containerized using Docker and deployed seamlessly to Google Cloud Run.

Prerequisites for Deployment

• Google Cloud SDK (gcloud CLI) installed and authenticated.
• A Google Cloud Project with an active billing account.
• The run.googleapis.com, artifactregistry.googleapis.com, and cloudbuild.googleapis.com APIs enabled in your GCP project.

Deployment Steps

You can deploy the application using the included PowerShell script or directly via the gcloud CLI.

Option 1: Using the Deployment Script (Windows/PowerShell) Simply execute the deployment script from the project root:

.\deploy.ps1

Option 2: Using the gcloud CLI Directly

gcloud run deploy tally-app \
  --source . \
  --region us-central1 \
  --allow-unauthenticated

Once the build and deployment process finishes, Google Cloud Run will provide you with a live URL where your app is hosted!

Contact Information

For any questions, feedback, or support regarding this project, please contact: Email: h.alesso@comcast.net