Vibe Praying

A full-stack web application built with FastAPI that creates random prayer partnerships. Each person is paired with two other people chosen randomly, and all results are persisted in a SQLite database.

Features

• Random Pairing: Each person is paired with exactly 2 other people randomly
• Persistent Storage: All pairing sessions are saved to SQLite database
• Modern UI: Clean, responsive design with smooth animations
• Session Management: View and reload previous pairing sessions
• Real-time Feedback: Loading states, success messages, and error handling
• Mobile Responsive: Works perfectly on desktop and mobile devices

Installation

1. Clone or download the project files

2. Install dependencies:

   pip install -r requirements.txt
   

3. Run the application:

   python app.py
   

4. Open your browser and navigate to:

   http://localhost:8000
   

Usage

1. Enter Names: Type or paste names into the text area, one name per line
2. Session Name: Optionally provide a name for your session
3. Create Vibes: Click the "Create Vibes" button to generate random partnerships
4. View Results: See all the prayer vibes displayed in a clean format
5. Previous Sessions: View and reload any previous pairing sessions

API Endpoints

• GET / - Main application page
• POST /create-pairs - Create new pairing session
• GET /sessions - Get all previous sessions
• GET /session/{session_id} - Get specific session details

Database Schema

The application uses SQLite with two main tables:

• pairing_sessions: Stores session metadata and pairing results
• pairs: Individual pair records (currently unused but available for future features)

Pairing Algorithm

The pairing algorithm ensures that:

• Each person is paired with exactly 2 other people
• No duplicate pairs are created
• Pairs are distributed as evenly as possible
• Results are truly random

Technology Stack

• Backend: FastAPI, SQLAlchemy, SQLite
• Frontend: HTML5, CSS3, Vanilla JavaScript
• Styling: Custom CSS with modern design patterns
• Icons: Font Awesome
• Fonts: Inter (Google Fonts)

Development

To run in development mode with auto-reload:

uvicorn app:app --reload --host 0.0.0.0 --port 8000

File Structure

prayer-pairing/
├── app.py                 # Main FastAPI application
├── requirements.txt       # Python dependencies
├── README.md             # This file
├── templates/
│   └── index.html        # Main HTML template
└── static/
    ├── css/
    │   └── style.css     # Stylesheets
    └── js/
        └── app.js        # Frontend JavaScript

Features in Detail

Random Vibe Logic

• Takes a list of names as input
• Creates vibes where each person is matched with 2 others
• Avoids duplicate vibes and self-pairing
• Handles edge cases (odd number of people, etc.)

Persistent Storage

• All sessions are automatically saved to SQLite database
• Sessions survive app restarts and crashes
• Previous sessions can be viewed and reloaded
• Database file: prayer_pairs.db

Modern UI/UX

• Gradient background with modern card design
• Smooth animations and hover effects
• Loading states and success feedback
• Error handling with user-friendly messages
• Responsive design for all screen sizes
• Keyboard shortcuts (Ctrl+Enter to create pairs)

Session Management

• View all previous pairing sessions
• Click any session to reload and view its pairs
• Session metadata (name, date, participants)
• Easy navigation between sessions

Browser Compatibility

• Chrome/Chromium (recommended)
• Firefox
• Safari
• Edge

License

This project is open source and available under the MIT License.