FairFlow

HomePage
Borrowing Lending Options
Borrower's Options
xAI Risk Analysis
Borrow Success
Borrower's Dashboard
Lender's Options
Lender's Dashboard
FairFlow Control Center
Local X Community Lending Updates
AI Chatbot
Using Vibe Kanban to streamline frontend development

Discords: luckieck5 - Rayhan | ree2023 - Shree | shaquilleoatmeal3281 - Andre

Inspiration

Neighbors everywhere are price-gouged by short-term credit—even when their spending shows they’re trustworthy. We wanted to prove a small community can lend to itself if everyone sees the same story: how you spend, why you’re borrowing, and the celebration when someone gets funded.

What it does

FairFlow lets any community turn spending transparency into shared credit. Borrowers link transaction data, Grok explains their clarity score, lenders match funds instantly, and every successful loan auto-posts to a shared X account so the whole community can cheer.

How we built it

FastAPI + SQLite to mock user onboarding, spending summaries, risk logic, and loan matching.
React (Vite, Tailwind, shadcn/ui, framer-motion) for the borrower journey and celebratory UI.
xAI Grok to transform raw spending into human risk narratives.
X API v2 (Bearer + OAuth1) to stream community tweets and publish loan wins.

Challenges we ran into

Translating mock Knot data into something Grok could infer essentials from.
Making OAuth1 write access behave (bearer tokens weren’t enough).
Keeping the flow generic for any neighborhood while still feeling personal. ## Accomplishments that we're proud of
Fully automated “loan matched → tweet posted” loop.
Grok narratives surfaced inline with the clarity score.
Community feed that blends live X updates with in-app milestones.

What we learned

Regenerating OAuth tokens after permission changes is mandatory.
Borrowers trust AI explanations when they see their own merchants in the copy.
Logging external API failures (Grok/X) early makes hackathon debugging painless.

What's next for FairFlow

Plug in real Knot connections and real lenders.
Let multiple neighborhoods run their own shared X feed from the same code.
Add opt-in storytelling (longer posts, donor shoutouts) so communities can rally around each success.