Build a platform where story has a format.

Stodia is a high-performance, modern social networking platform designed for diverse content sharing and community discovery. Built with a decoupled architecture using Laravel 12 and Next.js 16, it provides a lightning-fast, app-like experience (PWA) that redefines how users interact with media, location, and each other.
Whether you are launching a global social network, a professional portfolio hub, or a niche community, Stodia offers unparalleled flexibility through its modular post-type system and real-time engine.

🧪 Live Demo & Access

• Demo URL: https://demo.stodia.app/login
•  Username: demo
•  Password: 12345678

📄 Visit Online Docs URL: https://docs.stodia.app/

The Tech Stack

Stodia is built on the industry's most robust and scalable technologies:

• Backend API: Laravel 12 (PHP 8.2+)
• Frontend Client: Next.js 16 (React 19, TypeScript)
• Real-Time Engine: Laravel Reverb (WebSockets)
• Database & Cache: MySQL 8.0 & Redis
• Styling: Tailwind CSS 4.0 & Shadcn UI
• State Management: Zustand
• Maps: Pigeon Maps (OpenStreetMap) — Zero API costs.

Dynamic Post Ecosystem

Stodia goes far beyond simple status updates. With 20+ specialized post types, users can share content in unique, interactive formats:

• Blogs: Long-form articles with a rich-text Tiptap editor.
• Creative Portfolios: Showcase high-quality design and project work.
• Polls & Quizzes: Drive community engagement with interactive voting.
• Secrets & Magnifiers: Content hidden behind interaction for viral engagement.
• Typewriter: Beautifully animated text reveals for visual impact.
• Standard Media: Seamlessly upload high-res images and videos (FFMpeg compressed).
• Additional Types: Audio tracks, Event cards, Job listings, Check-ins, and more.

🚀 Stodia: Feature List

Account & Auth

• Multi-Auth: Email/Password and Social Login (Google, Twitter/X, Github).
• Sub-Profiles: Create up to 3 sub-accounts (personals/brands) under one main ID.
• Account Switcher: Switching between profiles .

Badges & Verification

• Category Badges: Professional, Business, Artist, and Verified identity icons.
• Subscription System: Paid monthly/yearly tiers via Wallet, Stripe and PayPal.

Content & Feeds

• For You Algorithm: Smart ranking based on engagement, recency, and topic followings.
• Following Feed: A clean, chronological view of people you know.
• Drafts & Scheduling: Save posts for later or schedule them for a specific UTC time.

Discovery & Search

• Live Suggestions: Real-time user and topic results as you type.
• Topic Explorer: A hierarchical tree of categories (Tech, News, Art, etc.) to browse.

Engagement Engine

• Real-time Interactions: Likes, Reposts, and Quotes update instantly across all screens.###li/li### nested>

Finance & Monetization

• Wallet: Personal balance system for users to hold funds.
• Deposits: Secure top-ups via Stripe and PayPal.
• Ad Center: Promote posts to the "For You" feed using budget/duration sliders.

Geolocation & Map

• Nearby Map: Interactive map showing where users are active.
• Nearby Feed: A unique feed that filters posts based on your physical radius (km).
• Reverse Geocoding: Automatically identifies your country and city for local feeds.

Handling (Media)

• Chunked Uploads: Support for huge 4K videos via 1MB chunked processing.
• Auto-Thumbnails: FFMpeg generates video posters on the fly.
• Dynamic Storage: Support for Local, S3, or R2 storage disks.
• Smart Compression: Dynamic WebP/JPG conversion with configurable quality and max-width resizing via .env.

Insights & Analytics

• Dashboard: Professional charts showing reach, views, and engagement over 30 days.
• Ad Tracking: Real-time monitoring of impressions and clicks for promoted posts.

Language & Local

• I18n Engine: Supports English, Bangla, Arabic (RTL), Spanish, and French and more.
• RTL Support: UI mirroring for Arabic and other RTL languages.

Messaging (Chat)

• Direct Messages: Private real-time chat with "Typing..." indicators.
• Chat Features: Img sharing, emoji reactions, and reply-to threading in DMs.
• Privacy DMs: Restrict who can message you.

Notifications

• Real-time Toasts: On-screen alerts for new activity.
• Push Notifications: Web-Push (PWA) support to get alerts even when the app is closed.

Privacy & Safety

• Private Accounts: Content hidden from non-followers (shows "Unavailable" card).
• Mute & Block: Complete control over your social circle and feed content.
• Sensitive Content: Toggle "Blur" for spoilers or sensitive media.

Reporting & Moderation

• User Reports: Multi-step reporting system for spam, hate speech, or harassment.
• Admin Panel: Control over user roles, banning, and global site settings.

SEO & Performance

• Dynamic Metadata: Automated OG tags for every user profile and post for social sharing.
• PWA: Add Stodia to your home screen for a native app-like experience.

Utility

• Image Cropper: Professional 1:1 and 16:9 cropping for avatars and covers.
• Pull-to-Refresh: Mobile-first gesture to update your timeline.(By Default Instant)

🖥️ Minimum System Requirements
To run the Stodia ecosystem (Laravel Backend + Next.js Frontend + Real-time Reverb), your server must meet these basics:

• RAM: Minimum 4 GB (Crucial to prevent Next.js build crashes and run API, DB & WebSockets simultaneously).
• CPU: Minimum 2 vCPU Cores.
• Storage: 40 GB+ SSD/NVMe (depending on user media uploads).
• OS: Ubuntu 22.04 LTS (Clean installation).

💡 Recommended Setup
For the best balance of speed, stability, and ease of use, we recommend:

• Virtualization: KVM (Kernel-based Virtual Machine).
• Control Panel: Like aaPanel (Where Nodejs and server proxy host possible, Highly Recommended for specialized Docker & Node environments).
• Best Value Provider: Example: Hostinger KVM 2 (2 vCPU / 8 GB RAM / 100 GB NVMe).

🚀 Highly Recommended: Deployment with Docker
We strongly recommend deploying Stodia using Docker. It is the fastest and most stable method for production.

• One-Command Setup: Install the entire stack (Backend, Frontend, DB, Redis) with a single command.
• Dependency Free: No need to manually install PHP, Node.js, or FFmpeg on your host OS; everything is pre-configured inside containers.
• System Stability: Each service runs in isolation, preventing conflicts and ensuring high performance

⚠️ Important Notice: Control Panel
We Highly Recommend using As Like aaPanel to manage your server. It provides the best compatibility with our Dockerized setup and automated SSL management.

N.B.: If you choose to use another control panel (such as cPanel, CyberPanel, or HestiaCP), you will be responsible for manually configuring the environment, reverse proxies, and ports. Our support is optimized for aaPanel and Docker environments.

🛠️ Software Stack (Manual Installation)
If you choose not to use Docker, you must manually configure:

• Backend: PHP 8.2 or 8.3 (Extensions: BCMath, Redis, Opcache, Exif, GD, Intl, Mbstring, XML).
• Database: MySQL 8.0+ or MariaDB 10.11+.
• Frontend: Node.js 20+ (Managed via PM2).
• Web Server: Nginx 1.24+ (Configured for Reverse Proxy).
• Real-time: Redis Server and open port 8080 for Laravel Reverb.
• Media: FFMpeg binaries installed on the host system.

🔒 Network Requirements

• SSL: Required (Let's Encrypt recommended).
• Ports: 80 (HTTP), 443 (HTTPS), 8080 (WebSockets).

🌐 Architecture Flexibility

You are not restricted to a single server. Stodia supports:

A. Monolithic Setup (Same Server)

Both Backend and Frontend live on the same VPS.

• Backend: api.yourdomain.com
• Frontend: yourdomain.com
• Connection: Internal communication via localhost.

B. Distributed Setup (Separate Servers)

Host the Backend and Frontend on completely different providers.

• Requirement: You must set CORS_ALLOWED_ORIGINS in the Backend .env to allow the external Frontend domain.

Stodia is designed for high-concurrency environments. For optimal performance, we provide a Docker-ready environment compatible with VPS(aaPanel).

• Deployment: Docker & Docker Compose provided.
• Recommended Panel: aaPanel (for easy management).
• Asset Management: Support for local storage or S3/R2 cloud storage.