Manage your subscription spending in one place 🚀

The frontend of Subsly is built with Angular and provides the user interface to view, add, edit, and track subscriptions.

To set up the frontend locally:

1. Clone the repository.

   git clone https://github.com/Waxer59/Subsly.git

2. Change the working directory to the frontend folder.

   cd Subsly/frontend

3. Install dependencies:

   pnpm install

4. Start the development server:

   pnpm start

The frontend uses the following technologies:

• Angular
• Tailwind CSS
• TypeScript
• Spartan UI
• ChartJs
• Lucide icons
• Zod

The backend of Subsly is implemented in Java with Spring Boot and exposes a REST API for managing subscriptions, users, etc.

To set up the backend locally:

1. Navigate to the backend directory:

   cd Subsly/backend

2. Install dependencies & build:

   ./mvnw clean install

3. Create environment configuration:

   cp .template.env .env

4. Fill in required environment variables in .env (DB credentials, API keys, etc).

5. Run the backend:

   ./mvnw spring-boot:run

The backend uses:

• Spring Boot
• Spring Data JPA
• PostgreSQL
• Swagger / OpenAPI for API documentation
• Sprint Security
• Spring Security OAuth2
• Lombok
• Jacoco
• JUnit

Subsly’s backend includes Swagger / OpenAPI documentation to explore and test all endpoints.

Once the backend is running, open your browser and visit:

http://localhost:<PORT>/api/swagger-ui/index.html

Replace <PORT> with the port the application listens on (configured in .env / application.yml).

Subsly includes a Chrome extension that lets users quickly add subscriptions from any website.

1. In Chrome, go to chrome://extensions.
2. Enable Developer mode.
3. Click Load unpacked and select the chrome-extension/dist folder.
4. The extension will install locally.

Use it to capture subscription services as you browse and add them to your Subsly dashboard.

The Chrome extension uses:

• TypeScript
• React
• Tailwind CSS
• crxjs