Skip to content

Home

Jump to bottom
Luara edited this page Jul 5, 2026 · 20 revisions

Felines Wiki

Educational platform, first and foremost — Felines exists to turn people who aren't cat people into guardians of stray cats, and the map is one of the actions it hands them once they're convinced, not the point of the product.

"Every world domination plan has the same problem: the already-convinced don't need convincing. We built a platform for everyone else."

Repository: https://github.com/luarawork/felines Built for: Hack the Kitty 2026 Stack: Next.js 16 · TypeScript · Supabase · Leaflet.js · Netlify

What is Felines?

Felines is a full-stack web platform with two core purposes, in order of what the product is actually built to do:

  1. Educate people who aren't cat people yet — converting conflicted neighbors, curious passersby, and averse citizens into community guardians through logic, not emotion. This is the point of the product: turn understanding into action.
  2. Map stray cat colonies collaboratively, with progressive location blur to protect the animals from malicious users. Mapping is one of the actions education leads to, not a separate goal competing with it.

The product was built solo for Hack the Kitty 2026, with 21 routes, 83 database migrations, full PT/EN internationalization, a complete Aikido Security audit, and WCAG 2.2 accessibility compliance.

Wiki Pages

Product & Strategy

Page What you'll find
Product Vision The problem, positioning, value proposition, competitor benchmark
User Personas 5 behavioral profiles, personas, the conversion arc
User Flows 6 core flows from anonymous visitor to daily caretaker
Design Decisions 18 documented decisions — what was chosen, discarded, and why
Hackathon Submission Judging criteria, judge profiles, submission checklist
Behind the Scenes The story behind the product's name, colors, and cat assistant

Design

Page What you'll find
Visual Identity Name, color palette, typography, tone of voice, design principles
UI Design System Component specs, animation timings, layout grid, accessibility implementation

Product & Features

Page What you'll find
Features Every feature, the motivation behind it, and how it was implemented
Content Strategy The 19 educational articles, glossary, and content approach

Engineering

Page What you'll find
Architecture Stack, folder structure, data flow, design decisions
Database 26 tables, RLS policies, RPCs, migrations overview
Security Progressive blur, Aikido findings, RLS testing, headers
API Reference RPCs documented with parameters and examples
Environment Setup How to run the project locally from scratch
Testing Methodology, flows tested, edge cases, security tests, WCAG audit

Process & Future

Page What you'll find
Process Log Day-by-day development diary with commits and decisions
Roadmap Expansion phases, future features, success metrics

Quick Start

git clone https://github.com/luarawork/felines
cd felines
npm install
# Create .env.local with required variables (see Environment Setup)
npm run dev

Open http://localhost:3000

Demo

Live URL: (add after deploy)

Demo account:

Key Numbers

  • 21 routes implemented
  • 83 database migrations
  • 26 tables with RLS enabled
  • 19 educational articles (PT/EN)
  • 36 glossary terms (PT/EN)
  • 14 real animal protection contacts in Natal, RN
  • 10 notification types
  • 9 emergency situation types
  • 9 cat assistant triggers
  • 2 Aikido Security vulnerabilities fixed (path traversal HIGH, SSRF LOW)
  • 40+ bugs found and fixed across many audit sessions, including a dedicated final pre-submission security pass

Clone this wiki locally