XClone Documentation

Thank you for purchasing XClone! This document covers all features, installation steps, and configuration details to help you get started with your new social media platform.

User Features

Navigation & UI

Left Sidebar

Intuitive navigation with active states and notification badges.

Links: Home, Explore, Notifications, Messages, Bookmarks, Communities, Profile.
"More" Menu: Access to Settings, Admin Dashboard (if admin), and Branding options.
Quick "Post" button.

Right Sidebar

Search: Global search for Users, Posts, and Hashtags.
What's Happening: Trending hashtags with post counts and categories.
Who to Follow: AI-powered user suggestions with "Follow" buttons.

Posting & Feed

Post Creation

Rich Text Editor with Emoji Picker.
Media: Upload multiple Images and Videos.
GIFs: Integrated GIPHY search.
Polls: Create interactive polls with custom duration.
Scheduling: Schedule posts for later publication.

Interactions

Like: Heart animation with counter.
Repost: Repost or Quote Post with comment.
Reply: Inline reply composer for quick engagement.
Views: visible view counter for every post.
Bookmark: Save posts privately.
Share: Copy link or native share menu.

Post Content

URL previews, YouTube video embedding, Hashtag/Mention linking.

Profile & Communities

Profile System

Customization: Cover Image (Banner) and Profile Avatar. Display Name, Bio, Location, Website, and Join Date.
Verification Badges: Support for multiple badge types:
- Blue (Premium/Person)
- Gold (Organization)
- Gray (Government)
- Green (Developer)
Profile Tabs: Posts, Replies, Bookmarks, Articles, Media, Likes.
Follow System: Follow/Unfollow with follower/following counts.

Communities

Create and Join Communities.
Dedicated Community Feeds.
Role-based permissions (Admin, Moderator, Member).

Messaging & Chat

Real-time private conversations (DMs).
Media sharing in chat.
Typing indicators and Read receipts.

Settings & Privacy

Account & Security

Account: Update email, username, password.
Security: Two-Factor Authentication (2FA), Active Sessions management, ID Verification.

Privacy

Control who can tag you or DM you.
Mute and Block users.
"Content you see" preferences.

Notifications & Display

Notifications: Granular control over Push and Email notifications (Likes, Mentions, new Posts, etc.).
Display:
- Dark Mode / Light Mode / Dim Mode.
- Theme Color personalization (Blue, Yellow, Pink, Purple, Orange, Green).
- Font size adjustment.

Monetization

Manage Premium Subscription and View Payment History.

Own Branding (SaaS / White Label)

Domains & Customization

Connect Domain: Users can link their own custom domain (e.g., user.com maps to xclone.com/user).
Buy Domain: Search and purchase domains directly within the app.
Developer Hosting: Advanced users can manage subdomains and FTP accounts.
DNS Instructions: Step-by-step guide for verifying domain ownership via TXT records.

User Management

List Users: Search, filter, and view all registered users.
Actions: Edit user details, Ban/Suspend users, Manually Verify users.
Login As User: Impersonate user for support debugging.

Content Moderation

Reports: View and manage reported posts/users.
Action: Delete violating content or dismiss reports.

System Configuration

Features Control: Toggle specific features on/off globally (e.g., Disable "Stories" or "Communities").
Settings: Configure Site Name, SEO limits, Upload limits.
Hosting: Monitor server storage and CPU usage.
Domains & TLDs: Manage pricing for sold domains (if SaaS mode active).

Monetization Management

Plans: Create, Edit, or Delete Premium Subscription plans.
Payments: View full transaction history and revenue reports.
Verification Requests: Review and Approve/Reject user verification applications.

Technology Stack & Requirements

Frontend

Framework: React 19 (Latest)
Build Tool: Vite (Blazing fast performance)
Styling: TailwindCSS (Modern utility-first CSS)
Icons: React Icons (FontAwesome, Material Design, etc.)
Language: TypeScript (Type-safe code)

Backend

Language: PHP 8.0+
Database: MySQL 5.7+ or MariaDB
API: RESTful JSON API structure
Auth: JWT (JSON Web Tokens) for secure authentication.

Server Requirements

PHP 8.0 or higher
MySQL Database
Apache/Nginx Web Server
SSL Certificate (Required for features like Copy to Clipboard, Voice rec, etc.)

Installation Guide (Backend)

Follow these steps to set up the server-side application.

Upload: Upload all files from the xclone folder to your server (e.g., public_html).
Database: Create a MySQL Database & User via cPanel or your hosting provider.

Config: Edit api/config/database.php with your DB credentials:

$host = 'localhost';
$db_name = 'your_db_name';
$username = 'your_db_user';
$password = 'your_db_pass';

Install: Run https://yourdomain.com/api/setup_db.php or open setup.html in your browser to automatically create the necessary database tables.
Permissions: Set 755 or 777 permission for the uploads/ and api/uploads/ directories to allow file creation.

Installation Guide (Frontend)

The frontend is located in the client folder and serves the user interface.

Install Node: Ensure Node.js (v18+) is installed locally on your machine.
Setup: Open your terminal, navigate to the client folder, and install dependencies:
```
cd client
npm install
```

Config: Edit client/src/config/api.ts. Update API_BASE to your backend URL:

// client/src/config/api.ts
export const API_BASE = "https://yourdomain.com";

Build: Create the production bundle:
```
npm run build
```
The output will be generated in the dist folder.
Upload: Upload the contents of the dist folder to your site's public root directory.
Routing: Ensure an .htaccess file exists in the root to handle React Routing (redirecting all requests to index.html).

Changelog

v1.0.0 - Initial Release

December 2025

Launch: Initial release of XClone social media platform.
Features: Complete feed, profile, communities, and messaging systems.
Admin: Full admin dashboard with SaaS and moderation tools.

Support

For installation support or bug reports, please contact us via the marketplace profile.