Documentation

Wiki & Docs

Everything you need to know about Nexus Development.

Welcome

Welcome to Nexus Development, where you can find any resource that will match every server. Nexus has two Executives (Owners), BradleyPlayZz, and BelikeAnything. Nexus was started in 8/18/25, but growth was slow, one resource a day, 11 people in our Discord. However, the big change was on 9/8/25, Nexus was given a Discord server with over 1.8k members. This allowed us to grow, and now we are receiving custom orders outside of BuiltByBit and posting up to 10+ resources a month. Nexus is one of the fast-growing studios founded by two server owners who know the struggles of not being able to find the right items for your server. Due to our two Executives, our Nexus resources are split between two different creators.

Test Server

Want to try before you buy? Join our test server to experience our plugins and builds firsthand. Contact us on Discord for access.

Useful Links

Services

Nexus Development Services

Monthly Services

Server Management $50/mo

  • Full server upkeep
  • Updates
  • Backups
  • Optimization

Tebex Setup & Management $40/mo

  • Configure Tebex store
  • Maintain Tebex store
  • Ensure smooth monetization

Database Optimization $45/mo

  • Organize server database
  • Improve performance
  • Ensure security

Discord Management $30โ€“$60/mo

  • Moderate community
  • Organize server
  • Maintain engagement and safety

Server Monitoring & Alerts $25/mo

  • Real-time server performance monitoring
  • Instant alerts for issues

One-Time Development Service

Plugin Development $20โ€“$80

Custom Minecraft plugins built to your specifications. Price varies by complexity.

Skript Development $5โ€“$50

Lightweight custom scripts, add server features, automate events.

Website Development $60

Responsive websites for communities or stores, tailored to your project.

Server Migration $30โ€“$60

Move server to new host with minimal downtime.

Event & Minigame Setup $15โ€“$50

Create minigames, setup events, seasonal features.

Discord Setup $25โ€“$50

Full server setup with roles, channels, permissions, and bots.

Discord Bot Development $20โ€“$70

Custom bots with commands, alerts, moderation, and community features.

Development Services $10โ€“$60

Configure items, oversee development work, manage server projects, implement custom features.

Wiki Creation $40โ€“$100

Build a complete server wiki with organized pages, categories, structure and layout.

Wiki Update $5โ€“$35

Update or expand existing wiki, add new pages or edit content, maintain structure.

Handbook / Document Creation $30โ€“$70

Design server handbooks, create guides or rulebooks with formatting, graphics, and organization.

Information

Prices can be discussed depending on whether the task is a small one. If you are interested, fill out a ticket in our Discord server.

Partnerships

The Nexus Partnership program is a very difficult program to get into. Whether you are a studio, server, or host. All servers must follow our strict rules to ensure every server we are a part of is like ours. A partnership isn't a handshake and it's done โ€” a partnership is us representing you and you representing us.

Why Partner With Us?

  • Server Hosts: Provide us with test servers for our products
  • Servers: Get our resources without paying for them
  • Studios: Collaborate with us โ€” e.g., a build studio partners with us and we post their builds with a revenue share

Requirements

Server Host

  • Small Host: 5+ servers with 3+ GB RAM, and a proxy server
  • Large Host: 7+ servers with 6+ GB RAM, and a proxy server
  • Good reviews

Studio โ€” Graphic Design

  • Good artwork
  • 10+ positive reviews
  • 20+ confirmed sales over $10
  • No use of AI

Studio โ€” Development

  • No use of AI
  • 20+ positive reviews
  • $300+ overall income (within one year)

Studio โ€” Builds

  • $40+ overall income (within one year)
  • 2+ positive reviews

Server

  • 20+ active players
  • Follows Discord & Minecraft's TOS
  • Not P2W / illegal scamming (pricing stuff really high then making a "discount" to trick people into thinking it is a steal)
  • 200+ users in the Discord
โš ๏ธ

Nexus is not accepting any partnerships with hosts at this time.

ReviveNode

ReviveNode is our official hosting partner. They provide fast, reliable servers for Minecraft and web hosting.

Use our affiliate link to get started:

Use code NEXUS for 15% off your first purchase.

BoxNoEnd

Coming soon.

TOS

Last updated: June 3, 2026 ยท Nexus Development

By purchasing, commissioning, downloading, or using any services or products from Nexus Development, you agree to the terms outlined below. If you do not agree, please do not proceed with our services.

1. Scope of Services

These terms apply to all work provided by Nexus Development, including Minecraft plugins, configurations, Discord bots, graphics, custom development work, and any digital deliverables. We may update these terms when necessary. Continued use of our services means you accept any revisions.

2. Payments & Refund Policy

Payments are final once work has started or files have been delivered. Deposits for custom work are non-refundable. Refunds are not issued for change of mind, compatibility issues outside our control, or features clearly described beforehand. Initiating a chargeback will result in immediate termination of service, revocation of usage rights, and possible blacklist from future work.

3. Usage Rights

When you purchase from Nexus Development, you receive a license to use the product โ€” not ownership of it. You may not resell, redistribute, upload publicly, include in other paid products, or claim our work as your own. This applies even if you modify the files.

4. Sharing & Code Restrictions

You are not permitted to share source code, compiled plugin files, bot code, configuration packages, graphics assets, or any portion of delivered work without explicit written approval. All intellectual property remains with Nexus Development.

5. Custom Commissions

Requirements must be clearly provided before development begins. Major changes after work starts may incur additional cost. Time estimates are just that โ€” estimates, not guarantees. We reserve the right to decline or cancel a commission if necessary.

6. Support & Revisions

We provide reasonable support for our work. Included: fixes for bugs directly caused by our code/config. Not included: feature additions, redesigns, compatibility fixes for third-party conflicts, or setup mistakes outside our control.

7. Termination of Service

We reserve the right to suspend or terminate services if these terms are violated, files are leaked or redistributed, harassment or abuse occurs, or payment disputes are filed. In these cases, licenses may be revoked immediately.

8. Liability

All products and services are provided as-is. Nexus Development is not responsible for server damage, data loss, financial losses, downtime, or compatibility issues outside our control.

9. Agreement

By using our services you confirm that you have read, understood, and agreed to these Terms of Service.

Privacy Policy

Last updated: June 3, 2026 ยท Nexus Development

Nexus Development respects your privacy. By using our services or joining our community, you agree to the practices described below.

1. Information We Collect

We only collect information necessary to operate our services: your Discord username/ID, messages or tickets sent to staff, order or commission details, payment-related contact information, and any files you choose to share. We do not collect sensitive personal information beyond what you voluntarily provide.

2. How We Use Your Information

Information is used to provide support and services, manage commissions and orders, communicate updates or issues, improve our workflows, enforce our Terms of Service, and prevent abuse or fraud. We do not sell or rent your information to third parties.

3. Data Sharing

We only share information when necessary: with trusted staff members working on your order, when required to comply with legal obligations, or to resolve disputes or enforce policies. We do not publicly disclose private client information.

4. Cookies & Local Storage

This website uses browser localStorage to store your session and preferences. No tracking cookies are used. You can clear this data at any time through your browser settings.

5. Third-Party Services

By interacting with Nexus Development, you may also interact with Discord, payment processors, and hosting services. These platforms have their own privacy policies, and we are not responsible for their practices.

6. Your Rights

You may request to review, correct, or delete information you have provided. Contact staff through our Discord server.

7. Contact

Questions? Contact us via Discord.

Plugin Installation

Coming soon.

NexusMinePay

Coming soon.

NexusMinePay โ€” Commands

Coming soon.

NexusMinePay โ€” Configuration

Coming soon.

NexusEconomy

Coming soon.

NexusEconomy โ€” Commands

Coming soon.

NexusEconomy โ€” Configuration

Coming soon.

NexusPets

Coming soon.

NexusPets โ€” Commands

Coming soon.

NexusPets โ€” Configuration

Coming soon.

NexusSpawners

Coming soon.

NexusSpawners โ€” Commands

Coming soon.

NexusSpawners โ€” Configuration

Coming soon.

NexusHeartTrade

Coming soon.

NexusHeartTrade โ€” Commands

Coming soon.

NexusHeartTrade โ€” Configuration

Coming soon.

NexusCells

Coming soon.

NexusCells โ€” Commands

Coming soon.

NexusCells โ€” Configuration

Coming soon.

NexusCells โ€” Permissions

Coming soon.

NexusCells โ€” Placeholders

Coming soon.

NexusStaffCore

Coming soon.

NexusCode

Coming soon.

NexusCode โ€” Commands

Coming soon.

NexusCode โ€” Configuration

Coming soon.

Bot Installation

This guide covers how to set up and run Discord bots provided by Nexus Development. All bots are built with Node.js and require a hosting environment to stay online 24/7.

Requirements

  • Node.js 18+ installed on your server
  • A Discord Bot Token from the Discord Developer Portal
  • npm or yarn package manager
  • A process manager like PM2 (recommended) or screen
  • Git (optional, for cloning repositories)

Step 1 โ€” Download the Bot

After purchase, download the bot files from your BuiltByBit account or the delivery DM. Extract the ZIP to a folder on your server.

Step 2 โ€” Install Dependencies

Open a terminal in the bot folder and run:

npm install

This installs all required packages listed in package.json.

Step 3 โ€” Configure the Bot

Create a .env file in the bot root (or edit config.json depending on the bot):

VariableDescription
TOKENYour Discord bot token
CLIENT_IDYour bot's application ID
GUILD_IDYour Discord server ID (for slash command testing)
PREFIXCommand prefix for message-based commands
MONGO_URIMongoDB connection string (if the bot uses a database)

Step 4 โ€” Register Slash Commands

Run the deploy command once to register commands with Discord:

node deploy-commands.js

This only needs to be done when commands change, not on every restart.

Step 5 โ€” Start the Bot

For testing:

node index.js

For production (runs in background, auto-restarts on crash):

npm install -g pm2
pm2 start index.js --name "nexus-bot"
pm2 save
pm2 startup

Step 6 โ€” Invite the Bot

In the Discord Developer Portal, go to OAuth2 > URL Generator:

  • Scopes: bot, applications.commands
  • Permissions: Select the permissions your bot needs (usually Administrator for full functionality)
  • Copy the generated URL and open it in your browser to invite the bot to your server

Updating the Bot

To update to a new version:

  1. Back up your .env or config.json
  2. Replace the bot files with the new version
  3. Run npm install to update dependencies
  4. Run node deploy-commands.js if commands changed
  5. Restart with pm2 restart nexus-bot

Need Hosting?

Use our affiliate link and code NEXUS for 15% off your first purchase at ReviveNode. Their VPS plans work great for Discord bots.

โš ๏ธ

Never commit your .env file or token to Git. Add .env to your .gitignore if using version control. Exposed tokens are automatically scanned and disabled by Discord.

Website Installation

All Nexus website templates are static HTML/CSS/JS files. No server-side processing or database is required. Follow the steps below to get your site online.

Requirements

  • A web server or static hosting provider (see recommended hosts below)
  • Basic knowledge of HTML/CSS for customization (optional)
  • A code editor such as VS Code, Sublime Text, or Notepad++

Step 1 โ€” Download & Extract

After purchase, download the ZIP file from your BuiltByBit account or the delivery DM. Extract the contents to a folder on your computer.

Step 2 โ€” Customize the Config

Open index.html in your code editor. Scroll to the CONFIG object near the top of the file (inside the <script> tag). Update the following fields:

  • brand.name โ€” Your name or studio name
  • brand.logo โ€” Your initials or logo text
  • hero.title โ€” Your headline
  • hero.description โ€” Your tagline
  • contact.info โ€” Your email, Discord, location
  • contact.socials โ€” Your social media links
  • footer.creditName โ€” Who built the site (you)

Step 3 โ€” Add Your Images

Replace placeholder images in the /assets folder (or root) with your own. Update image paths in the CONFIG object under work.items and hero.visual.

Step 4 โ€” Upload to Your Host

Upload all files to your web server via FTP, SFTP, or your host's file manager. Ensure index.html is in the root (public_html) directory.

ReviveNode Discount

Need reliable web hosting? Use our affiliate link and code NEXUS for 15% off your first purchase at ReviveNode.

Recommended Static Hosts

HostTypePriceBest For
GitHub PagesStaticFreeDevelopers, portfolios
VercelStatic / ServerlessFree tierFast global CDN
NetlifyStaticFree tierDrag & drop deploy
Cloudflare PagesStaticFreeSpeed & security
ReviveNodeWeb HostingPaidFull cPanel control โ€” use code NEXUS for 15% off

Step 5 โ€” Connect Your Domain (Optional)

Point your domain's A record to your host's IP, or update nameservers if provided by your registrar. SSL certificates are usually free and auto-configured by most modern hosts.

Pro Tip

If you purchased the Blog Addon, upload blog.html to the same directory as index.html. The navigation links between pages are relative, so they will work automatically as long as both files are in the same folder.

โš ๏ธ

Do not rename the main HTML files unless you update all internal links. The template expects index.html and blog.html to exist in the same directory.

Nova Portfolio

$7.00 USD

Nova Portfolio is a premium, single-page portfolio template designed for freelancers, designers, developers, and creative studios. Built with clean, modern aesthetics and a fully editable JavaScript config object โ€” no build tools or frameworks required.

What's Included

  • index.html โ€” Complete single-page portfolio
  • Responsive design (mobile, tablet, desktop)
  • Dark theme with ambient glow effects
  • Scroll reveal animations
  • Working contact form (frontend-ready)
  • SEO-friendly semantic HTML

Live Preview

See the template in action before you buy. Contact us on Discord for a live demo link.

Support

Basic setup help is included with your purchase. For advanced customization, open a ticket in our Discord server.

Nova Portfolio โ€” Features

Sections Overview

SectionDescriptionConfigurable
HeroFull-screen intro with badge, headline, description, and profile cardYes
MarqueeInfinite scrolling client/logo barYes
ServicesNumbered list of offerings with pricingYes
Work / PortfolioGrid of project cards with hover effectsYes
ExperienceVertical timeline with job historyYes
PricingThree-tier pricing cardsYes
TestimonialsClient review cards with star ratingsYes
ContactInfo panel + working contact formYes

Design Highlights

  • Space Grotesk + Inter font pairing for a modern, editorial feel
  • Indigo / Violet accent gradient with glow effects
  • Glassmorphism navbar with blur backdrop and pill shape
  • Bento-style grid for portfolio items with asymmetric spans
  • Sticky experience sidebar on desktop for easy reading
  • Mobile-first responsive breakpoints at 1024px and 768px

Technical Specs

  • Pure HTML5, CSS3, vanilla JavaScript โ€” zero dependencies
  • No build step required; edit and deploy instantly
  • Google Fonts loaded via CDN
  • SVG icons embedded inline (no icon font needed)
  • Intersection Observer for scroll-triggered animations
  • CSS Grid and Flexbox throughout

Nova Portfolio โ€” Configuration

Every piece of content is controlled by the CONFIG object at the top of index.html. No need to touch HTML markup.

Brand Settings

KeyTypeDescription
brand.namestringSite name shown in navbar and footer
brand.logostringInitials or short text for avatar marks
brand.titlestringPage title suffix

Navigation

KeyTypeDescription
nav.linksarrayNavbar anchor links (label + href)
nav.ctaobjectPrimary button text and link

Hero Section

KeyTypeDescription
hero.badgestringStatus pill text (e.g. "Open for projects")
hero.titlearrayTwo-line headline
hero.descriptionstringSubtitle paragraph
hero.ctaPrimaryobjectMain button label + href
hero.ctaSecondaryobjectGhost button label + href
hero.visualobjectProfile card: name, role, tags, stats

Services

Each service item supports:

  • num โ€” Number label (01, 02, etc.)
  • name โ€” Service title
  • description โ€” Short explanation
  • price โ€” Displayed price text

Work / Portfolio

Each project supports:

  • title โ€” Project name
  • category โ€” Tag shown on card
  • year โ€” Display year
  • description โ€” Card excerpt
  • image โ€” URL or leave empty for placeholder
  • link โ€” Destination URL

Pricing Plans

Set featured: true on any plan to highlight it with an accent border and badge. Use price: "Custom" for open-ended tiers.

Contact Form

The form is frontend-only. To make it functional, connect it to:

  • Formspree โ€” Change the form action attribute
  • EmailJS โ€” Add their SDK and send via JavaScript
  • Your own backend endpoint

Theme Colors

KeyDefaultDescription
theme.accent#6366f1Primary indigo
theme.accentSecondary#8b5cf6Violet gradient end

Quick Tip

Changing theme.accent and theme.accentSecondary updates every button, link, badge, and glow effect across the entire site automatically.

Nova Portfolio โ€” Blog Addon

$2.99 USD

The Blog Addon is an optional add-on for Nova Portfolio. It adds a fully functional blog system It includes a listing page with featured posts, individual article pages with rich content support, and a built-in content management system via a JavaScript array โ€” no CMS or database needed.

What's Included

  • blog.html โ€” Complete blog engine
  • Featured post support (spans 2 columns)
  • Individual post pages via URL parameters
  • Read time estimation display
  • Category tags and date metadata
  • Back navigation between post and listing
  • Responsive grid layout

Requirements

  • Nova Portfolio base template (purchased separately)
  • blog.html must reside in the same directory as index.html

Live Preview

Contact us on Discord for a demo of the blog addon in action.

Nova Portfolio โ€” Blog Addon Configuration

All blog content is managed through the BLOG_POSTS array inside blog.html. No external tools or databases are required.

Post Object Structure

PropertyTypeRequiredDescription
idstringYesURL-friendly slug (no spaces)
titlestringYesPost headline
excerptstringYesShort description for listing cards
datestringYesAny date format you prefer
tagstringYesCategory label (e.g. Design, Dev)
readTimestringYesDisplay text (e.g. "5 min read")
imagestringNoURL or empty string for placeholder
featuredbooleanNotrue spans 2 columns on listing
contentarrayYesArray of HTML strings for the article body

Adding a New Post

  1. Open blog.html in your code editor
  2. Locate the BLOG_POSTS array inside the <script> tag
  3. Copy an existing post object (including the curly braces)
  4. Paste it after the last post, adding a comma after the previous closing brace
  5. Update all fields with your new content
  6. Save and upload to your host

Supported Content HTML

The content array accepts raw HTML strings. The following elements are styled by default:

ElementUsage
<p>Standard paragraphs
<h2>Section headings
<h3>Subsection headings
<ul> / <li>Bulleted lists
<blockquote>Pull quotes (left accent border)
<code>Inline code (accent color)
<pre><code>Code blocks with background

Example Post

Example

{
  id: "my-first-post",
  title: "My First Blog Post",
  excerpt: "A short description for the card.",
  date: "June 9, 2026",
  tag: "General",
  readTime: "3 min read",
  image: "",
  featured: false,
  content: [
    "<p>This is my first paragraph.</p>",
    "<h2>A Section Heading</h2>",
    "<p>Another paragraph here.</p>"
  ]
}

URL Structure

Posts are accessed via URL parameters:

  • Listing page: blog.html
  • Individual post: blog.html?post=my-first-post

Share the full URL with ?post= to link directly to an article.

โš ๏ธ

Post IDs must be unique. Duplicate IDs will cause the first matching post to load. Use URL-friendly slugs with no spaces or special characters (hyphens recommended).

Flux Panel โ€” How to Download

After purchasing Flux Panel, you receive access to the source files. Unlike a simple ZIP download, Flux is delivered as a set of PHP files that you copy into your host one by one. Here is the exact process.

What You Get

Your purchase includes the following files, all prefixed with flux-:

  • flux-config.php โ€” Database and payment gateway configuration
  • flux-login.php โ€” Admin login page
  • flux-register.php โ€” First-time account creation
  • flux-logout.php โ€” Session destroy and redirect
  • flux-header.php / flux-footer.php โ€” Shared page layout
  • flux-dashboard.php โ€” Main admin dashboard
  • flux-commissions.php โ€” Commission management
  • flux-quotes.php โ€” Quote creation and lifecycle
  • flux-invoices.php โ€” Invoice generation and tracking
  • flux-clients.php / flux-client-portal.php โ€” Client management and external portal
  • flux-changes.php โ€” Change request system
  • flux-calendar.php โ€” Deadline and event calendar
  • flux-products.php โ€” Services catalog
  • flux-settings.php โ€” Panel configuration
  • flux-setup.sql โ€” MySQL database schema

Step 1 โ€” Upload the Files

Choose one of the following methods based on your hosting setup:

Option A: cPanel File Manager (Easiest)

  1. Log into your hosting account and open File Manager
  2. Navigate to public_html (or your web root)
  3. Create a new folder named flux (recommended) or upload directly to root
  4. Click Upload and select each flux-*.php file one by one
  5. Upload flux-setup.sql as well (delete it after importing)

Option B: FTP Client (Better for Bulk)

  1. Download FileZilla (free)
  2. Enter your host's FTP credentials: Host, Username, Password, Port 21
  3. Drag and drop all flux-*.php files from your computer to the public_html/flux/ folder on the right side

Option C: SSH / Terminal (If You Have Access)

  1. Connect to your server: ssh username@yourdomain.com
  2. Navigate to your web root: cd public_html
  3. Create files with a text editor like nano: nano flux-config.php
  4. Paste the code, then press Ctrl+X, Y, Enter to save

Step 2 โ€” Create the Database

Flux requires a MySQL database. If your host uses cPanel:

  1. Find MySQL Databases or phpMyAdmin in cPanel
  2. Create a new database (e.g., flux_panel)
  3. Create a database user and password
  4. Grant the user all privileges on the database
  5. Open phpMyAdmin, select your database, click Import
  6. Choose flux-setup.sql and click Go

Step 3 โ€” Edit flux-config.php

Before the panel will work, you must update these lines in flux-config.php with your real credentials:

ConstantWhat to Enter
FLUX_DB_HOSTUsually localhost
FLUX_DB_NAMEThe database name you created
FLUX_DB_USERThe database username
FLUX_DB_PASSThe database password
FLUX_BASE_URLYour full URL, e.g. https://yourdomain.com/flux/

Step 4 โ€” First Run

  1. Visit https://yourdomain.com/flux/flux-register.php in your browser
  2. Create your admin account
  3. Sign in at flux-login.php
  4. Delete flux-setup.sql from your server for security
โš ๏ธ

Do not share your flux-config.php file. It contains your database password and payment gateway keys. If you need help, share screenshots of errors rather than the full file.

Need Hosting?

Use our affiliate link and code NEXUS for 15% off your first purchase at ReviveNode.

Flux Panel โ€” Installation

Flux is a self-hosted PHP dashboard for freelancers. This guide covers requirements, database setup, configuration, and first-time access.

Requirements

  • PHP 8.3 or higher with PDO, GD, and cURL extensions
  • MySQL 5.7+ or MariaDB 10.3+
  • Apache, Nginx, or OpenLiteSpeed with mod_rewrite enabled
  • SSL certificate (required for Stripe/PayPal webhooks)
  • Cron job access for automated tasks

Step 1 โ€” Upload Files

Extract the Flux package and upload all flux-*.php files, the assets/ directory, and .htaccess to your web root or a subdirectory.

Step 2 โ€” Create the Database

Import flux-setup.sql via phpMyAdmin or the MySQL CLI:

mysql -u your_user -p your_database < flux-setup.sql

Step 3 โ€” Configure Database Connection

Open flux-config.php and update the following constants:

ConstantDescription
DB_HOSTDatabase hostname (usually localhost)
DB_NAMEName of the database you created
DB_USERDatabase username
DB_PASSDatabase password
DB_CHARSETCharacter set (default utf8mb4)

Step 4 โ€” Set Base URL & Branding

In flux-config.php, set your panel URL and brand name:

ConstantDescription
BASE_URLFull URL to your Flux installation (e.g., https://panel.yoursite.com/)
BRAND_NAMEYour business name displayed in the header and emails
TIMEZONEPHP timezone string (e.g., America/New_York)

Step 5 โ€” Configure Payment Gateways

Flux supports Stripe and PayPal for invoice payments. Add your keys in flux-config.php:

ConstantDescription
STRIPE_PKStripe Publishable Key
STRIPE_SKStripe Secret Key
STRIPE_WEBHOOKStripe Webhook Secret
PAYPAL_CLIENTPayPal Client ID
PAYPAL_SECRETPayPal Secret
PAYPAL_SANDBOXSet to true for testing, false for live

Step 6 โ€” Set Up Cron Jobs

Add the following cron jobs for automated tasks:

# Daily analytics snapshot
0 0 * * * /usr/bin/php /path/to/flux-cron-daily.php

# Hourly invoice status sync
0 * * * * /usr/bin/php /path/to/flux-cron-hourly.php

Step 7 โ€” First Login

Navigate to flux-install.php in your browser to create the first admin account. Delete flux-install.php immediately after setup.

โš ๏ธ

Delete flux-install.php after first run. Leaving it accessible allows anyone to create an admin account.

Need Hosting?

Use our affiliate link and code NEXUS for 15% off your first purchase at ReviveNode.

Flux Panel

Flux is a self-hosted freelancer commission and client management dashboard built in PHP 8.3 and MySQL. It gives you full control over your workflow โ€” from the first client inquiry to final invoice payment โ€” without relying on third-party SaaS platforms.

What's Included

  • Admin dashboard with revenue analytics and commission tracking
  • Full commission lifecycle management (unstarted to completed)
  • Quote creation, sending, and client approval workflow
  • Invoice generation with Stripe and PayPal payment processing
  • Client management with individual portal logins
  • Change request system for scope adjustments
  • Calendar for deadlines and milestones
  • Products and services catalog
  • Role-based access control
  • Dark theme UI optimized for long work sessions

Tech Stack

LayerTechnology
BackendPHP 8.3, vanilla (no framework dependency)
DatabaseMySQL / MariaDB with PDO prepared statements
FrontendVanilla JavaScript, CSS Grid, Flexbox
ChartsChart.js (loaded via CDN)
PaymentsStripe Checkout + PayPal REST API
AuthSession-based with bcrypt password hashing

File Structure

Every file is prefixed with flux- to avoid conflicts with existing projects:

  • flux-config.php โ€” Core configuration and database connection
  • flux-auth.php โ€” Login, logout, and session management
  • flux-header.php / flux-footer.php โ€” Shared layout shell
  • flux-dashboard.php โ€” Main admin dashboard
  • flux-commissions.php โ€” Commission list and detail views
  • flux-quotes.php โ€” Quote creation and management
  • flux-invoices.php โ€” Invoice generation and tracking
  • flux-clients.php โ€” Client directory and profiles
  • flux-client-portal.php โ€” External client login area
  • flux-changes.php โ€” Change request handling
  • flux-calendar.php โ€” Deadline and event calendar
  • flux-products.php โ€” Services and pricing catalog
  • flux-settings.php โ€” Panel configuration
  • flux-setup.sql โ€” Database schema

Support

Basic setup help is included with your purchase. For customization or advanced integrations, open a ticket in our Discord server.

Dashboard

The Flux Dashboard is your command center. It surfaces the metrics and activity that matter most to your freelance business at a glance.

Key Metrics

MetricDescription
Total RevenueSum of all paid invoices (lifetime)
Pending RevenueSum of unpaid / pending invoices
Active CommissionsCommissions with status In Progress or Awaiting Client
Pending QuotesQuotes sent to clients awaiting response
Overdue InvoicesInvoices past their due date
New Clients (30d)Clients added in the last 30 days

Recent Activity Feed

The activity feed shows a chronological list of actions across your panel: new commissions, quote responses, invoice payments, change requests, and client logins. Each entry includes a timestamp and a link to the relevant record.

Quick Actions

  • Create new commission
  • Draft a quote
  • Generate invoice from commission
  • Add a new client
  • Log a change request

Analytics & Charts

Flux tracks revenue and commission data over time and renders interactive charts on the Dashboard page.

Revenue Chart

A line chart showing paid invoice totals grouped by month. Data is aggregated from the invoices table where status is paid. Hover over points to see exact amounts.

Commission Status Breakdown

A doughnut chart showing the distribution of commissions across statuses: Unstarted, In Progress, Awaiting Client, On Hold, and Completed. Useful for identifying bottlenecks in your pipeline.

Client Growth

A bar chart tracking new client acquisitions per month. Helps identify seasonal trends in your business.

Data Refresh

Charts query live data on each Dashboard load. For large datasets, consider enabling the daily cron snapshot in flux-config.php to cache aggregated results.

Managing Commissions

Commissions are the core of Flux. A commission represents a single project or deliverable from initial inquiry to completion.

Creating a Commission

  1. Navigate to Commissions and click New Commission
  2. Select an existing client or create a new one inline
  3. Enter a title, description, and select the service from your Products catalog
  4. Set a deadline (optional) and assign a priority level
  5. Save. The commission starts in Unstarted status

Commission Detail View

Click any commission to open its detail page. From here you can:

  • Edit title, description, and deadline
  • Update status (see Status Workflow)
  • Attach files and notes
  • Generate a quote
  • Generate an invoice
  • View linked change requests
  • View activity history

Filtering & Search

The commissions list supports filtering by status, client, date range, and priority. Use the search bar to find commissions by title or client name.

Commission Status Workflow

Flux uses a fixed set of statuses to track where each commission stands. Status changes are logged in the activity feed.

StatusMeaningTypical Next Step
UnstartedCommission created but work has not begunMove to In Progress or send a Quote
In ProgressActive work is being doneMove to Awaiting Client or On Hold
Awaiting ClientWaiting on client feedback, assets, or approvalMove back to In Progress or to Completed
On HoldPaused indefinitelyMove to In Progress when unblocked
CompletedDelivered and acceptedGenerate final invoice if not already sent
CancelledProject terminatedNo further action

Status Change Rules

  • Only admins and assigned staff can change status
  • Clients see status updates in their portal but cannot change them
  • Moving to Completed requires all linked invoices to be paid (configurable in Settings)
  • Cancelled commissions are excluded from revenue calculations

Creating Quotes

Quotes let you send formal pricing to clients before work begins. A quote can be created from a commission or independently.

From a Commission

  1. Open the commission detail page
  2. Click Generate Quote
  3. Line items are pre-filled from the commission's linked product
  4. Add or remove line items as needed
  5. Set an expiry date (default is 14 days)
  6. Save as draft or send immediately

Standalone Quote

  1. Navigate to Quotes and click New Quote
  2. Select a client or enter details manually
  3. Add line items with descriptions, quantities, and unit prices
  4. Set terms, expiry, and optional notes
  5. Save or send

Quote Line Items

Each line item has:

  • Description โ€” What the charge is for
  • Quantity โ€” Number of units
  • Unit Price โ€” Price per unit
  • Total โ€” Auto-calculated (quantity x unit price)

Tax and discounts are applied at the quote level and configured in Settings.

Quote Lifecycle

Quotes move through a simple lifecycle from creation to resolution.

StatusDescription
DraftCreated but not yet sent to client. Editable.
SentEmail dispatched to client with a secure viewing link. Locked from editing.
AcceptedClient approved the quote. Can be converted to a commission or invoice.
DeclinedClient rejected the quote. Reason is logged if provided.
ExpiredPast the expiry date without client response.

Client Quote View

When you send a quote, the client receives an email with a unique link to flux-client-portal.php?view=quote&id=XXX. No login is required for quote viewing, but the link contains a secure token that expires when the quote is resolved.

Converting a Quote

  • To Commission: Click Convert to Commission on an accepted quote. Pre-fills a new commission with client and line item data.
  • To Invoice: Click Generate Invoice to create a billable invoice from the accepted quote total.

Invoice Management

Invoices in Flux are tied to commissions and clients. They support partial payments, overdue tracking, and automated reminders.

Creating an Invoice

  1. Open a commission and click Generate Invoice, or go to Invoices and click New Invoice
  2. Select the client and commission (if applicable)
  3. Add line items or import from a linked quote
  4. Set issue date, due date, and payment terms
  5. Add a note or terms footer (optional)
  6. Save as draft or send to client

Invoice Statuses

StatusDescription
DraftCreated but not sent. Editable.
SentDelivered to client. Awaiting payment.
PartialSome payment received but balance remains.
PaidFull balance received. Locked.
OverduePast due date without full payment.
CancelledVoided by admin. No longer payable.

Invoice PDF

Flux generates a clean PDF for every invoice using a built-in template. The PDF includes your brand name, address, logo (uploaded in Settings), line items, totals, and payment instructions. Clients can download the PDF from their portal.

Stripe & PayPal Integration

Flux supports two payment gateways out of the box. You can enable one, both, or neither.

Stripe Setup

  1. Create a Stripe account at stripe.com
  2. Get your Publishable Key and Secret Key from the Developers dashboard
  3. Create a webhook endpoint pointing to https://yoursite.com/flux-webhook-stripe.php
  4. Select events: checkout.session.completed, invoice.payment_succeeded
  5. Copy the Webhook Signing Secret
  6. Paste all three values into flux-config.php

PayPal Setup

  1. Create a PayPal Developer app at developer.paypal.com
  2. Copy the Client ID and Secret
  3. Set PAYPAL_SANDBOX to true for testing
  4. Create a webhook pointing to https://yoursite.com/flux-webhook-paypal.php
  5. Select event: PAYMENT.CAPTURE.COMPLETED
  6. Paste credentials into flux-config.php

Payment Flow

When a client clicks Pay Invoice in their portal:

  1. They are redirected to Stripe Checkout or PayPal depending on your enabled gateways
  2. After payment, the gateway sends a webhook to Flux
  3. Flux verifies the webhook signature and updates the invoice status to Paid or Partial
  4. The client sees a confirmation page and receives a receipt email
  5. The admin Dashboard revenue metrics update automatically
โš ๏ธ

Webhooks require a public HTTPS URL. Localhost and HTTP-only sites cannot receive live payment confirmations. Use Stripe CLI or PayPal Sandbox for local development.

Client Management

The Clients section is your directory of everyone you work with. Each client record centralizes contact info, commission history, quotes, invoices, and portal access.

Adding a Client

  1. Go to Clients and click New Client
  2. Enter name, email, and optional details (company, phone, Discord, timezone)
  3. Set portal access: Enabled or Disabled
  4. If enabled, a temporary password is generated and emailed to the client
  5. The client can log in at flux-client-portal.php and change their password

Client Profile

Each client page shows:

  • Contact details and notes
  • Total lifetime revenue from this client
  • List of all commissions with status indicators
  • All quotes sent and their outcomes
  • All invoices with payment status
  • Activity timeline

Import / Export

Export your full client list as CSV from the Clients page. Import is supported via CSV upload with a mapped column template.

Client Portal

The Client Portal is a separate, simplified interface where your clients can view their quotes, invoices, and commission statuses without seeing your admin panel or other clients' data.

Portal URL

Direct clients to https://yoursite.com/flux-client-portal.php. They log in with the email and temporary password you generated. They can change their password after first login.

What Clients See

  • Dashboard โ€” Active commissions, pending quotes, unpaid invoices
  • Quotes โ€” View, accept, or decline quotes with optional comments
  • Invoices โ€” View details, download PDF, and pay online
  • Commissions โ€” Status, deadlines, and attached files you have shared
  • Change Requests โ€” Submit new change requests and track existing ones

What Clients Cannot Do

  • See other clients' data
  • Access the admin panel or settings
  • Modify commission details, quotes, or invoices
  • View your revenue or analytics

Branding

The client portal uses your BRAND_NAME and logo from Settings. Colors match the admin theme.

Handling Change Requests

Change requests allow clients to request scope adjustments after a commission is already in progress. This keeps scope creep documented and billable.

Creating a Change Request

Clients can submit change requests from their portal. Admins can also create them from the commission detail page.

  1. Click New Change Request on a commission
  2. Describe the requested change
  3. Estimate additional time and cost
  4. Submit for client review (if created by admin) or mark as pending review (if from client)

Approval Workflow

StatusDescription
PendingSubmitted, awaiting review
Under ReviewAdmin is evaluating feasibility and cost
ApprovedClient accepted the additional cost. A new invoice line item is suggested.
DeclinedClient rejected the cost or the change is not feasible
ImplementedChange has been completed and billed

Billing Changes

Approved change requests can be converted to invoice line items or added to an existing draft invoice. This ensures every scope change is tracked and paid for.

Calendar

The Flux Calendar displays deadlines, milestones, and events across all commissions. It helps you visualize your workload and avoid overcommitting.

Event Types

TypeColorSource
Commission DeadlineRedAuto from commission due dates
Quote ExpiryYellowAuto from quote expiry dates
Invoice DueOrangeAuto from invoice due dates
Custom EventTealManually added by admin

Views

  • Month โ€” Standard grid view with event dots
  • Week โ€” Detailed week view for tight deadlines
  • List โ€” Chronological list of upcoming events

Adding Custom Events

Click any date in Month or Week view to add a custom event. Custom events are internal-only and not visible to clients.

Product Catalog

The Products section is your services menu. Define what you offer, set base prices, and link products to commissions and quotes for faster creation.

Creating a Product

  1. Go to Products and click New Product
  2. Enter a name (e.g., "Logo Design", "Website Development")
  3. Add a description for quote pre-fill
  4. Set a base price and estimated delivery time
  5. Assign a category for organization
  6. Toggle visibility: visible products appear in commission creation dropdowns

Using Products

  • When creating a commission, selecting a product auto-fills the description and price
  • Quote line items can pull from the product catalog
  • Products can be archived without deleting historical data

Pricing Flexibility

Product prices are suggestions. You can override the price on any commission or quote without changing the catalog entry.

Settings

The Settings page controls panel-wide behavior, branding, and business rules.

General

SettingDescription
Brand NameDisplayed in header, emails, and PDFs
Brand LogoUpload a PNG/JPG for invoice PDFs and client portal
Business AddressShown on invoice PDFs
TimezoneAffects all date/time displays
CurrencyDefault currency symbol and code

Invoicing

SettingDescription
Default Payment TermsNet 7, Net 14, Net 30, or custom
Tax RatePercentage applied to all invoices (0 to disable)
Auto-RemindersSend overdue reminder emails after N days
Require Paid Invoices for CompletionBlock commission completion until all invoices are paid

Quotes

SettingDescription
Default ExpiryDays until a quote expires (default 14)
Allow Client CommentsClients can add notes when accepting/declining

Client Portal

SettingDescription
Portal EnabledGlobal toggle for client portal access
Allow RegistrationClients can self-register (disabled by default)
Show Revenue to ClientsDisplay total spent on their profile (disabled by default)

Security

SettingDescription
Max Login AttemptsLockout threshold for brute force protection
Session LifetimeMinutes until inactive logout
Two-Factor AuthEnable TOTP for admin accounts

Need Hosting?

Use our affiliate link and code NEXUS for 15% off your first purchase at ReviveNode.