Skip to content

SpeaksOut is a prototype social platform designed specifically for college students to share anonymous confessions.

License

Notifications You must be signed in to change notification settings

chaursia/speaksout

Repository files navigation

πŸŽ“ SpeaksOut - College Confessions Platform

SpeaksOut Version License

A Twitter-like platform for college students to share anonymous confessions

Live Demo

πŸ“– About The Project

SpeaksOut is a prototype social platform designed specifically for college students to share anonymous confessions, thoughts, and experiences in a safe and engaging environment. Think of it as Twitter meets anonymous confessions, tailored for campus life.

🎯 Why SpeaksOut?

  • Safe Space: Anonymous confession sharing for genuine expression
  • Campus-Focused: Designed specifically for college communities
  • Modern UI: Clean, intuitive interface with light/dark mode
  • Real-time Features: Live interactions and trending content

✨ Features

πŸ—£οΈ Core Functionality

  • Anonymous Confessions: Post confessions without revealing identity
  • Profile Management: User profiles with confession history
  • Real-time Chat: Direct messaging between users
  • Social Interactions: Like, share on confessions
  • Content Moderation: Report inappropriate content

πŸ“Š Community Features

  • Trending Confessions: Discover what's hot on campus
  • Hashtag System: Categorize and discover confessions
  • University Leaderboard: Campus engagement rankings

🎨 User Experience

  • Light/Dark Mode: Toggle between themes
  • Responsive Design: Optimized for all devices
  • Real-time Updates: Live feed and notifications
  • Intuitive Navigation: Easy-to-use interface

πŸš€ Live Demo

Check out the live prototype: https://speaksout.vercel.app/

πŸ› οΈ Tech Stack

Frontend

  • HTML5 - Markup structure
  • CSS3 - Styling and animations
  • JavaScript (ES6+) - Client-side functionality
  • No Frameworks - Pure vanilla implementation

Backend & Database

  • Supabase - Backend-as-a-Service
  • PostgreSQL - Database management
  • Real-time Subscriptions - Live updates

Deployment

  • Vercel - Static site hosting
  • Git - Version control

πŸ“¦ Installation

Want to run SpeaksOut locally? Follow these steps:

Prerequisites

  • Modern web browser
  • Git
  • Local server (optional, for full functionality)

Local Development

  1. Clone the repository

    git clone https://github.com/chaursia/speaksout
    cd speaksout
  2. Set up Supabase (if needed)

    • Create a Supabase project
    • Configure environment variables
    • Set up database schema
  3. Run locally

    # Using Python
    python -m http.server 8000
    
    # Using Node.js
    npx http-server
    
    # Using PHP
    php -S localhost:8000
  4. Access the application Open http://localhost:8000 in your browser

πŸ“± Usage

For Students

  1. Browse Confessions: View the main feed of campus confessions
  2. Post Anonymously: Share your thoughts without revealing identity
  3. Interact: Like, comment, and share interesting confessions
  4. Discover Trends: See what's trending on your campus
  5. Chat Privately: Message other users (with privacy controls)

Features in Action

  • Light/Dark Mode: Toggle in user settings
  • Hashtag Navigation: Click any hashtag to explore related content
  • Leaderboard: Check your university's ranking
  • Real-time Updates: See new confessions as they're posted

🀝 Contributing

As this is a prototype, we welcome feedback and suggestions! Here's how you can contribute:

  1. Fork the Project
  2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
  3. Commit your Changes (git commit -m 'Add some AmazingFeature')
  4. Push to the Branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

πŸ› Known Limitations

As a Prototype

  • Static implementation (no server-side rendering)
  • Basic error handling
  • Limited browser compatibility testing
  • Simplified authentication flow

Planned Improvements

  • PWA implementation
  • Mobile app version
  • Advanced moderation tools
  • University verification system
  • Enhanced privacy features

πŸ“„ License

This project is licensed under the MIT License.

πŸ‘₯ Authors

  • DIvyanshu Chaursia - Initial work - Chaursia

πŸ™ Acknowledgments

  • College students who provided feedback during development
  • Supabase for the excellent backend service
  • Vercel for seamless deployment
  • The open-source community for inspiration

πŸ“ž Support

If you have any questions or need help with the setup:


Made with ❀️ for college communities

⭐ Star us on GitHub if you find this project helpful!

About

SpeaksOut is a prototype social platform designed specifically for college students to share anonymous confessions.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published