Skip to content

NamNguyenSparta/spartahack11-actual

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

11 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐ŸŽ“ Credence - Your AI-Powered Financial Assistant for Students

Built for those the credit system forgot.
Credence is a modern, privacy-first financial management platform designed specifically for students, young professionals, and anyone who is "credit invisible."

Credence Banner React Vite


โžก๏ธ Try it out!

https://credenceai.vercel.app

๐Ÿ“– What is Credence?

Credence is a complete financial life manager for students. Unlike traditional credit scoring apps that only show you a number, Credence helps you:

  • ๐Ÿ“Š Understand your financial health through AI-powered analysis
  • ๐Ÿ’ธ Track loans, scholarships, tuition costs, and aid in one place
  • ๐Ÿ“ˆ Grow your wealth with investment tracking (stocks, crypto, forex)
  • ๐Ÿค– Get Advice from specialized AI agents that act like your personal accountant

Think of it as having a financial advisor, accountant, and mentor โ€” all in your pocket, powered by AI.


โœจ Features

1. ๐Ÿ  Dashboard

Your financial command center. See your "Trust Score" at a glance โ€” a holistic measure of your financial reliability that traditional credit scores can't capture.

What you'll see:

  • Your current Trust Score (0-100)
  • Score trend over time (are you improving?)
  • Quick stats: Payment reliability, Savings rate, Income stability
  • AI agents working on your behalf

2. ๐ŸŽ“ Finance Manager (Student Hub)

The heart of Credence for students. This is where you manage your entire academic financial journey.

Features:

  • Financial Timeline: A visual roadmap of your semesters, showing:
    • Tuition costs per semester
    • Student loans taken
    • Scholarships and grants received
    • Work-study income
    • Internship earnings
  • Quick Stats Bar: See totals at a glance
    • Total loans accumulated
    • Total income/aid received
    • Degree ROI (Return on Investment)
  • AI Strategy Agent: A personalized AI that:
    • Greets you by name ("Hey Yash!")
    • Analyzes your specific situation
    • Gives actionable advice (e.g., "Take the internship to reduce loan burden by 18%")
  • Debt vs Wealth View: Automatically switches between:
    • "Debt Crusher" mode (if you have loans) โ€” red theme, payoff projections
    • "Wealth Builder" mode (if you're saving) โ€” green theme, growth projections
  • Action Alerts: Reminders for FAFSA renewal, scholarship deadlines, etc.

3. ๐Ÿ“ˆ Investment Portfolio

Track all your investments in one place โ€” no more switching between 5 different apps!

Supported Asset Types:

  • Stocks: Apple, S&P 500 ETFs, individual companies
  • Cryptocurrency: Bitcoin, Ethereum, and more
  • Forex: Currency pairs like EUR/USD

Features:

  • Connect your accounts (Robinhood, Coinbase โ€” simulated for demo)
  • See total portfolio value and 24-hour change
  • Individual holdings with real-time prices
  • Portfolio growth chart over time
  • AI Investment Agent that provides allocation advice

4. ๐Ÿ’ณ My Wallet

A beautiful card and transaction management interface that shows:

Credit Card Display:

  • Stunning gradient credit card with glassmorphism effects
  • Personalized cardholder name automatically pulled from your login
  • Card number, expiry date, and Mastercard branding
  • Current balance and credit limit display

All Transactions:

  • Complete transaction history across all accounts
  • Category icons (food, shopping, subscriptions, income, education)
  • Positive/negative amounts clearly highlighted
  • Real-time total balance calculation
  • Transaction dates and status (completed/pending)

Quick Actions:

  • Transfer funds
  • Deposit money
  • Additional options

5. ๐Ÿค– AI Accountant (Insights Page)

Get deep analysis of your financial behavior from our multi-agent AI system.

How it works: Each aspect of your finances is analyzed by a specialized AI agent:

Agent Role What It Analyzes
๐Ÿ’ณ Payment Agent Conservative Evaluator Bill payment history, reliability
๐Ÿฆ Savings Agent Long-term Planner Emergency fund, savings rate
๐Ÿ’ผ Income Agent Risk Assessor Income stability, gig economy gaps
๐Ÿ“Š Spending Agent Behavioral Economist Spending patterns, impulse control
๐Ÿ“ˆ Investment Agent Wealth Builder Portfolio diversity, risk tolerance
๐ŸŽฏ Risk Agent Sentiment Analyst Overall financial risk profile

These agents "discuss" your profile and reach a consensus on your score.


6. ๐Ÿ›‚ Trust Passport

A shareable, privacy-preserving document that proves your financial trustworthiness to landlords, employers, or lenders โ€” without exposing your raw bank data.

๐ŸŽฏ The Problem It Solves

When students need to rent an apartment, lease a car, or apply for a credit card, they face a catch-22: "You need credit history to get credit, but you can't get credit without credit history."

Trust Passport creates a digital letter of recommendation for your finances.

โœ… What Verifiers SEE

Information Example
Trust Score 84/100
AI Council Consensus 85% agreement
Confidence Level High
Risk Tier Low Risk
Behavioral Indicators "Payment reliability positive", "Savings behavior stable"

๐Ÿ”’ What Stays HIDDEN (Privacy-Preserved)

Hidden Information
โŒ Bank account balances
โŒ Transaction details
โŒ Exact income amounts
โŒ Personal financial data
โŒ Account numbers

๐Ÿ”„ How It Works

  1. User clicks "Generate Trust Passport"
  2. The system creates a unique shareable URL like:
    https://credence.app/verify/yash-1738...
    
  3. User shares this link with a landlord, employer, or lender
  4. The verifier opens the link and sees your verified trust profile

๐Ÿ  Real-World Example

"Hey, I'm a student with no credit history. Instead of a co-signer, here's my Credence Trust Passport showing my 84/100 Trust Score verified by 6 AI agents. It proves I pay bills on time and have stable savings patterns."

The landlord clicks the link, sees the verified passport, and can make a decision based on behavioral reliability rather than just a credit score.

๐Ÿ”‘ Key Differentiator

Traditional credit reports share your entire financial history. Credence Passport shares only behavioral signals โ€” proving you're reliable without exposing how much money you have.

It's like proving you're a safe driver without showing your car's GPS history.


7. ๐Ÿ”ฎ Future Simulator

Play "what-if" scenarios with your finances!

Examples:

  • "What if I increase my savings by $200/month?"
  • "What if I miss a payment?"
  • "What if I get a summer internship?"

Watch your Trust Score change in real-time as you adjust sliders.


8. ๐ŸŒ™ Dark Mode

A beautiful, eye-friendly dark theme that works across the entire app. Toggle it with one click in the sidebar.


๐Ÿ‘ฅ Demo Personas

To showcase different financial situations, Credence includes three demo profiles:

Persona Description Scenario
๐ŸŽ“ Scholarship Student Low debt, good savings Best-case student scenario
๐Ÿ’ธ Student w/ Loans High debt, working to pay down Common reality for many students
โญ Graduated Alumni Post-grad, aggressive loan payoff Life after graduation

Switch between personas in the sidebar to see how the app adapts.


๐Ÿ› ๏ธ Technology Stack

Frontend

Technology Purpose
React 18 UI framework for building interactive interfaces
Vite Lightning-fast development server and bundler
React Router Navigation between pages
Recharts Beautiful, responsive charts for visualizations
Lucide React Modern, consistent icon library
CSS Variables Theming system for light/dark mode

Backend

Technology Purpose
Node.js JavaScript runtime for the server
Express Web framework for API endpoints
Python AI/ML processing scripts

AI & Intelligence

Technology Purpose
Gemini API Google's large language model for AI agents
MCP (Model Context Protocol) Standardized way to connect AI models to external data
Multi-Agent System Six specialized AI agents analyze different aspects

Design

Approach Details
Glassmorphism Modern frosted-glass UI effects
CSS Variables Theme tokens for consistent styling
Responsive Design Works on desktop, tablet, and mobile
Micro-animations Subtle transitions for premium feel

๐Ÿš€ Getting Started

Prerequisites

  • Node.js 18+ installed
  • npm or yarn package manager

Installation

  1. Clone the repository

    git clone https://github.com/your-username/credence.git
    cd credence
  2. Install dependencies

    npm install
  3. Start the development server

    npm run dev
  4. Open your browser

    http://localhost:5173
    

Running the Backend (Optional)

If you want AI features to work fully:

cd backend
npm install
npm start

The backend runs on http://localhost:3001.

๐Ÿš€ Deploy to Vercel

This project is optimized for Vercel deployment:

  1. Push to GitHub

    git add .
    git commit -m "Ready for deployment"
    git push origin main
  2. Import to Vercel

    • Go to vercel.com
    • Click "New Project"
    • Import your GitHub repository
    • Framework preset will be auto-detected as Vite
    • Click "Deploy"
  3. That's it! Your app will be live at https://your-project.vercel.app

Note: The vercel.json file is already configured for SPA routing and security headers.


๐Ÿ“ Project Structure

credence/
โ”œโ”€โ”€ src/
โ”‚   โ”œโ”€โ”€ components/         # Reusable UI components
โ”‚   โ”‚   โ””โ”€โ”€ Layout/         # Sidebar and page layout
โ”‚   โ”œโ”€โ”€ context/            # React Context for global state
โ”‚   โ”‚   โ””โ”€โ”€ AppContext.jsx  # Main state management
โ”‚   โ”œโ”€โ”€ pages/              # Main application pages
โ”‚   โ”‚   โ”œโ”€โ”€ Login/          # Beautiful login page
โ”‚   โ”‚   โ”œโ”€โ”€ Dashboard/      # Home dashboard with welcome
โ”‚   โ”‚   โ”œโ”€โ”€ StudentHub/     # Finance Manager
โ”‚   โ”‚   โ”œโ”€โ”€ Wallet/         # Credit card & transactions
โ”‚   โ”‚   โ”œโ”€โ”€ Investments/    # Investment Portfolio
โ”‚   โ”‚   โ”œโ”€โ”€ Insights/       # AI Accountant
โ”‚   โ”‚   โ”œโ”€โ”€ Passport/       # Trust Passport
โ”‚   โ”‚   โ”œโ”€โ”€ Simulator/      # What-If Simulator
โ”‚   โ”‚   โ””โ”€โ”€ BusinessView/   # B2B underwriting view
โ”‚   โ”œโ”€โ”€ App.jsx             # Main app with routing
โ”‚   โ””โ”€โ”€ index.css           # Global styles and themes
โ”œโ”€โ”€ backend/                # Node.js API server
โ”œโ”€โ”€ vercel.json             # Vercel deployment config
โ”œโ”€โ”€ public/                 # Static assets
โ””โ”€โ”€ README.md               # This file!

๐ŸŽจ Design Philosophy

  1. Student-First: Every feature is designed with students in mind
  2. Privacy-Preserving: We never store raw bank data
  3. AI-Powered: Agents provide personalized, actionable advice
  4. Beautiful by Default: Premium aesthetics out of the box
  5. Accessible: Works for everyone, including the "credit invisible"

๐Ÿ† Built for SpartaHack XI (2026)

This project was created for SpartaHack XI with the mission of democratizing financial trust for students and young people who are often excluded from traditional credit systems.

The Problem

  • Approximately 49 million Americans have no credit score (Oliver Wyman, 2026)
  • Students can't get apartments, loans, or credit cards
  • Traditional credit scoring ignores savings, income stability, and financial behavior

Our Solution

Credence creates a holistic financial identity that captures:

  • Payment reliability (not just credit cards)
  • Savings behavior
  • Income consistency
  • Spending patterns
  • Investment activity

๐Ÿ“„ License

MIT License - Feel free to use and modify!


๐Ÿ‘จโ€๐Ÿ’ป Team

Built with โค๏ธ by the Credence team at SpartaHack XI.


"Built for the credit invisible."

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages