What I Learned Building a Full-Stack HR Platform in 12 Weeks

💔 Why I Built It

I've lived the chaos: scattered spreadsheets, unclear approvals, reactive instead of proactive renewals, and managers/contractors asking the same questions across different tools. In previous marketplace roles, I could feel the gap: we needed clearer communication, shared context, and simple paths for doing the right thing—without a scavenger hunt.

"In all the marketplaces I've contracted through, no one has checked in. You feel like you're on an island."
— 1099 contractor

One outreach call made it painfully concrete. A 1099 contractor told me she felt like she was on an island. I was proud that my team's check-ins changed her experience—but I hated that feeling alone had become normal.

The Core Problem: Contingent workers feel isolated. Managers lack visibility. Recognition gets lost in chats. Contract renewals happen at the last minute. Questions get asked again and again across different tools. Everyone's reactive instead of proactive.

AuniConnect is my answer to that. It puts people back in the loop.

🎯 What AuniConnect Does

From Isolation to Connection:
• From isolation → connection (recognition, check-ins, shared context)
• From guesswork → clarity (role-aware views, next-step prompts)
• From reactive → proactive (renewal visibility, weekly rhythms)
• From tool sprawl → one place to do the right thing

🎖️ Recognition That Travels

Wins are visible, not lost in Slack. Kudos tied to company values with weekly stats and dashboard previews.

👥 Role-Aware Workflows

Managers, admins, and contractors see what's theirs to do—nothing more, nothing less. Three distinct experiences.

🤖 Gentle AI Nudges

Aunikah turns "Where do I...?" into "Already done." FAQ answers, next-step suggestions, and escalation logging.

📅 Rhythms, Not Heroics

Weekly challenges and renewal visibility replace last-minute scrambles. Proactive by design.

12

Weeks to First Release

3

Role Views (Admin/Manager/Talent)

6+

Core Features Shipped

⚙️ The Tech Stack (Short & Sweet)

Backend: Flask (Python) - Minimal ceremony, fast iteration
Frontend: HTML, CSS, vanilla JavaScript - Custom theme + dark mode
Data: JSON files for speed; migrating to SQLite/Postgres for concurrency & analytics
AI Assists: ChatGPT (planning, scaffolding, debugging) + Claude (UI polish, formatting, manager-coaching tone)

AI Strategy That Worked: Using two LLMs for different strengths (ChatGPT for speed, Claude for polish) noticeably sped up shipping. ChatGPT was a great rubber duck for tricky bugs. Claude helped the manager-coaching voice feel natural.

🎓 Key Lessons Learned

1. Flask over Django for speed.
I needed to ship pages, not frameworks. Minimal ceremony wins during proof-of-value. Django's structure would have slowed me down.

2. Roles are product, not just permissions.
Contractors, managers, and admins think in different workflows. Designing by role tasks simplified UI and reduced conditionals. Treat roles like distinct products.

3. Dark mode isn't "just a theme."
A 3-day rabbit hole taught me to centralize CSS variables (--bg, --text, spacing) and reuse components. Design tokens first. Test with real data, not lorem ipsum.

4. "Make it work" first, then harden it.
JSON let me iterate fast. Now that flows are stable, migrating to a DB is straightforward and justified. Prototype with files, architect for a DB.

5. AI shines when it's narrow and contextual.
Aunikah handles FAQs, suggests next steps, and logs escalations. It's not trying to do everything - just the things that reduce friction and help people do the right thing.

🔥 Biggest Challenges (and Fixes)

Challenge 1: UI Drift

Problem: Forms looked fine in one view and broken in another (light mode unreadable, odd spacing).

Solution: Centralized form styles & typography, introduced design tokens with CSS custom properties, and tested with real content.

Challenge 2: Role Logic Sprawl

Problem: Templates filled with if admin/manager/contractor conditionals.

Solution: Route-level guards + role-scoped partials. Each role gets a dedicated dashboard with only the actions they need.

Challenge 3: Files Work... Until They Don't

Problem: Concurrent writes are risky and analytics (e.g., kudos by tag/week) can get slow.

Solution: Abstracted file access behind helpers that can be swapped for SQLite/Postgres. Prototype with files, architect for a DB.

✨ Core Features Shipped

Manager Portal

Approvals, team insights, and manager coaching cues from Aunikah. Everything managers need in one view.

Aunikah Chatbot

FAQ answers, gentle nudges, and escalation logging to admins. 24/7 HR concierge that actually helps.

Kudos & Recognition

Tags (Teamwork, Innovation, etc.), weekly stats, and dashboard previews. Recognition that travels with the work.

Weekly Challenges

Mon–Fri streaks, completion tracking, and admin challenge editor. Building engagement rhythms.

Renewal Radar

T-60/45/30/15 alerts for upcoming contract expirations. Proactive retention instead of reactive surprises.

Assignment Lifecycle

Comprehensive talent database with client assignments, employment types, EOR tracking, and full audit history.

🚀 What This Demonstrates

Building AuniConnect showcases several capabilities that translate directly to HRIS and People Operations roles:

Systems thinking: Understanding how engagement, operations, and AI interconnect
Product development: Making strategic scope decisions, prioritizing features, iterating based on real needs
Technical execution: Shipping working software with modern tools and AI assistance
User experience design: Building role-aware interfaces that simplify complex workflows
0→1 thinking: The type of execution early-stage companies need when building HR systems from scratch

"This isn't just a demo project—it's a working platform that solves real problems I experienced firsthand."

Building AuniConnect