Claim Check

Project Description

Claim Check is a web app that helps people quickly check if a statement is likely true or likely false.

You type or paste a claim (or even a full article text). The app sends it to the backend, which asks Gemini AI to search the web, gather informations and compare the results. Then the app shows:

• a verdict (for example: likely true, likely false, mixed evidence, or not enough information),
• a short explanation in plain language,
• source links used for the conclusion.

Users can create an account, sign in, and track their daily check quota.

Tech Stack

• Frontend: Angular 19, TypeScript
• UI: PrimeNG, PrimeIcons, Tailwind CSS 4, SCSS
• Backend: Spring Boot 3 (Java 21), Spring Web, Spring Security, Spring Data JPA, Spring Validation
• Auth: JWT (JSON Web Token)
• Database: PostgreSQL
• AI verification: Google Gemini API (gemini-2.5-flash) with Google Search tool enabled
• API docs: Swagger UI / OpenAPI (springdoc)
• Build tools: Maven Wrapper (mvnw), npm
• Testing stack: JUnit 5, Spring Boot Test, Spring Security Test, Testcontainers, H2 (test scope)

How To Run Locally

1) Prerequisites

• Java 21
• Node.js and npm
• PostgreSQL running locally

2) Start the Backend (Spring Boot)

cd spring_boot_server
cp .env.example .env

Edit .env and set your real values:

• SPRING_DATASOURCE_URL
• SPRING_DATASOURCE_USERNAME
• SPRING_DATASOURCE_PASSWORD
• GEMINI_API_KEY
• JWT_SECRET

Add this line so backend port matches frontend config:

SERVER_PORT=5000

Run the backend:

./mvnw spring-boot:run

Backend will be available at:

• http://localhost:5000
• Swagger UI: http://localhost:5000/swagger-ui.html

3) Start the Frontend (Angular)

In a new terminal:

cd angular_client
npm install
npm run start -- --configuration production

Frontend will be available at:

• http://localhost:4200

Quick Usage

1. Register a new account.
2. Log in.
3. Paste a claim in the input box.
4. Submit and read the verdict, explanation, and sources.