Skip to content

Home

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

Felines Wiki

Educational platform that maps stray cat colonies and converts everyday citizens into guardians — without requiring them to love cats first.

"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

For the human-readable product pitch, see the README. This wiki holds everything that's too detailed for the README but still needs to live on GitHub — per hackathon judging feedback, content that only exists in Notion may not be considered during judging, so every page below has been migrated here directly, not just linked externally.

What is Felines?

Felines is a full-stack web platform with two core purposes:

  1. Map stray cat colonies collaboratively, with progressive location blur to protect the animals from malicious users
  2. Educate people who aren't cat people yet — converting conflicted neighbors, curious passersby, and averse citizens into community guardians through logic, not emotion

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