Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Appearance settings

Hakimaj/PeerSupport

Open more actions menu

Repository files navigation

Peer Support Web App

An empathy-first peer-support web application with opt-in anonymity, strong moderation, crisis workflows, privacy-by-design, and modular social spaces.

Features

Core Pages

  • Landing/Trust Page: Clear mission, safety notice, crisis links, privacy tagline
  • Onboarding Flow: Two paths (anonymous & identified) with minimal data collection
  • Home Feed: Community stream with filters (All/Local/Anonymous/Topics)
  • Groups/Circles: Topic-based communities (public, private, invite-only)
  • Chat: 1:1 and group chat with real-time features
  • Share/Post Composer: Step-by-step flow with safety checks and risk detection
  • Personal Dashboard: Stories, mood tracker, achievements, settings
  • Resources & Emergency: Crisis lines, international hotlines, local resources
  • Identity & Anonymity Settings: Privacy controls and data audit
  • Admin/Moderator Dashboard: Moderation queue, analytics, user risk management

Key Features

  • Three Identity Modes: Fully anonymous guest, pseudonymous account, verified account
  • Privacy by Design: Minimal data collection, encrypted storage, clear consent
  • Safety & Moderation: Automated detection, community reporting, human moderators
  • Crisis Workflows: Immediate help UI, crisis line integration, escalation protocols
  • Accessibility: WCAG AA/AAA compliant, keyboard navigable, screen-reader tested
  • Responsive Design: Mobile-first, large tap targets, minimized typing

Tech Stack

  • Framework: Next.js 14 (App Router)
  • Language: TypeScript
  • Styling: Tailwind CSS
  • Icons: React Icons
  • State Management: Zustand (for future use)

Getting Started

Prerequisites

  • Node.js 18+
  • npm or yarn

Installation

  1. Install dependencies:
npm install
  1. Run the development server:
npm run dev
  1. Open http://localhost:3000 in your browser.

Project Structure

app/
  ├── page.tsx              # Landing/Trust page
  ├── onboarding/           # Onboarding flow
  ├── home/                 # Home feed
  ├── share/                # Post composer
  ├── groups/               # Groups listing and detail
  ├── chat/                 # Chat interface
  ├── dashboard/            # Personal dashboard
  ├── resources/            # Crisis resources
  ├── settings/identity/    # Identity & privacy settings
  └── admin/                # Admin/moderation dashboard

Design Principles

  • Empathy-First: Supportive, non-judgmental tone throughout
  • Privacy by Design: Minimal data collection, user control
  • Safety First: Automated detection, moderation, crisis workflows
  • Accessibility: WCAG compliant, keyboard navigable
  • Mobile-First: Responsive design, large tap targets

Color Palette

  • Primary: Soft blues (#0073e6) - Trust, calm
  • Support: Soft greens (#4cbe82) - Growth, support
  • Crisis: Warm orange (#ff8f00) - Urgency, attention

Future Enhancements

  • Real-time WebSocket integration for chat
  • Backend API integration
  • Database setup
  • Authentication system
  • Moderation tools backend
  • Analytics dashboard
  • Mobile app

License

This project is for educational/demonstration purposes.

About

Full-stack peer support web app with JWT auth, real-time WebSocket chat, image uploads, role-based admin panel, and emotional reaction system. Spring Boot + Mysql

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages

Morty Proxy This is a proxified and sanitized view of the page, visit original site.