Welcome to Finorova

Server Requirements

Before you install Finorova, make sure your hosting environment meets the following requirements. The installer also checks these automatically in Step 1.

PHP Version

PHP 8.2 or later is required. PHP 8.3 is recommended for best performance.

Required PHP Extensions

The following PHP extensions must be enabled on your server:

• pdo
• pdo_mysql
• curl
• mbstring
• openssl
• tokenizer
• xml
• json
• fileinfo

Database

MySQL 5.7+ or MariaDB 10.3+.

Folder Permissions

The following paths must be writable by the web server (typically chmod 775):

• .env file (in the project root)
• storage/ folder
• bootstrap/cache/ folder

Installation

Finorova ships with a guided web installer — no command line required. Follow the three steps below.

https://yourdomain.com/install/

Quick Start

Three steps to get up and running after installation:

1. Log in as Admin — visit /login with the credentials created during install.
2. Configure General Settings — set your app name, logo, currency, timezone and SMTP.
3. Create a Plan — define at least one subscription plan so users can sign up.

Cron Setup

Finorova relies on a single server-side cron job to power every recurring task — auto-recording bills, sending email reminders, expiring trials, and flagging overdue debts. The application will appear to "do nothing" automatic until this one cron entry is in place.

* * * * * cd /home/youraccount/public_html && /usr/local/bin/php artisan schedule:run >> /dev/null 2>&1

crontab -e

* * * * * cd /var/www/finorova && php artisan schedule:run >> /dev/null 2>&1

crontab -l

cd /path/to/finorova && php artisan schedule:list

php artisan schedule:run

Admin Dashboard

Overview Stats

Top-level snapshot of total users, active subscriptions, monthly revenue, and pending manual payments. Quick links to recent activity.

Settings

General Settings

Set your app name, logo, favicon, timezone, default locale, currency format and footer text. Configure SMTP for outgoing emails.

Payment Gateway

Enable and configure supported gateways (Stripe, PayPal, manual transfer). Add API keys and webhook URLs in one place.

Users

User Management

View, search and filter all registered users. Activate or suspend accounts, reset passwords, and inspect each user's workspaces and subscription history.

Plans

Subscription Plans

Create monthly and yearly plans with custom pricing, feature limits, and trial periods. Mark plans as featured or hide them from the pricing page.

Subscriptions

Active Subscriptions

Browse every active subscription, filter by plan or status, extend or cancel manually, and view the full billing history per user.

Payments

Online Payments

Full log of automated gateway transactions — Stripe, PayPal, etc. Filter by status, refund directly from the panel.

Features

Marketing Features

Manage the feature blocks shown on the public landing page — title, description, and icon. Drag to reorder.

Workflows

Process Workflows

Define the "How it works" steps shown on the landing page (Sign up → Add accounts → Track expenses → Get reports). Edit copy and icons.

Testimonials

Customer Quotes

Add, edit and reorder testimonials displayed on the public homepage. Includes name, role, company, photo and quote text.

FAQs

Frequently Asked Questions

Maintain the public FAQ block. Group questions by category and toggle visibility per item.

Reports

Three platform-level reports for the SaaS owner:

• Revenue Report
• User Growth
• Subscription Stats

Insights at a Glance

Filter by date range, export to CSV, and visualize revenue, signups, and subscription conversion trends.

User Dashboard

Personal Overview

Total balance, monthly income, monthly expense and net savings — with trend badges, charts, and quick actions to add a transaction.

Workspace

All Workspaces

Create separate workspaces for personal, family, business, or any group. Switch between them from the sidebar.

Members

Invite teammates by email, assign roles, and remove access anytime. Each member sees only what their role permits.

Roles & Permissions

Create custom roles (Owner, Editor, Viewer) and choose exactly which modules each role can access — accounts, transactions, reports.

Accounts

Manage Accounts

Accounts represent any place where money lives — bank accounts, cash on hand, credit cards, mobile wallets, investment accounts, and more. Every transaction must be tied to an account, and the system keeps each account's running balance up to date automatically.

Fields You Can Set

• Name — display label (e.g. "HSBC Checking").
• Type — Cash, Bank, Mobile, Card, Wallet, Investment, or Other.
• Currency — 3-letter ISO code (defaults to USD).
• Starting balance — opening balance when the account is created.
• Color & icon — visual identification across the dashboard.
• Exclude from total — hides this account from the workspace total balance (useful for long-term savings).
• Low-balance threshold — sends an alert when the balance drops below this value.
• Active / Inactive — inactive accounts stay archived but selectable in historical views.

Categories

Income & Expense Categories

Organize transactions with custom income and expense categories (Salary, Groceries, Rent, etc.). Color-code and nest sub-categories.

Transactions

All Transactions

Every money flow in the system — income that arrives into an account or an expense that leaves it. The list is paginated, searchable, and filterable by type, account, category and date range.

Add Income / Expense

One form for both directions — pick type, account, category, amount and date. Optionally attach a receipt, write a reference number, or mark the transaction as recurring.

Fields You Can Set

• Type — Income (adds to balance) or Expense (subtracts from balance).
• Account — which account the money moves through.
• Category — optional but recommended; budgets and the Category Breakdown report rely on it.
• Amount, date, description, reference — standard ledger fields.
• Attachment — upload a receipt or invoice for record keeping.
• Recurring — flag used by reporting; full recurring automation lives in Bills.

Transfers

Account Transfers

Move money between two of your own accounts without polluting your income or expense totals. A transfer debits one account and credits another in a single, atomic step.

Fields You Can Set

• From account & To account — source and destination, must be different accounts in the same workspace.
• Amount — credited to the destination account.
• Fee — optional. Deducted from the source account but not credited to the destination (think wire transfer or ATM fee).
• Transfer date — the effective date of the move.
• Note — optional memo.

Budgets

Category Budgets

Cap how much you can spend in a given category over a defined period — monthly, quarterly, yearly, or a custom range. Budgets watch every new expense in real time and alert you as you approach or exceed the limit.

Fields You Can Set

• Name — a friendly label (e.g. "Groceries — Jan").
• Category — must be an expense category. One budget tracks one category.
• Amount — the spending limit.
• Period — Monthly, Quarterly, Yearly, or Custom.
• Start date & end date — for preset periods the end date is filled in automatically (e.g. start Jan 1 + Monthly → end Jan 31); for Custom you set both ends manually.
• Active toggle — disables alert emails without deleting the budget.

Status & Alerts

Status is recomputed for every view based on usage = spent / amount × 100:

• On track — under 80%.
• Warning — between 80% and 99%.
• Exceeded — 100% or more.

Alerts fire when you cross the 80% and 100% thresholds. Each threshold only fires once per budget (tracked by last_alerted_threshold), so you don't get spammed when small transactions push usage back and forth across the line.

Goals

Savings Goals

Set a savings target (e.g. "Vacation fund — $2,000 by December"), then log contributions as you put money aside. The system tracks progress, calculates how much is left, warns when you're falling behind, and auto-completes the goal the moment you hit your target.

Fields You Can Set

• Name & icon — what you're saving for.
• Target amount — the number you're aiming at.
• Current amount — starting balance (defaults to 0).
• Target date — optional deadline; drives the "overdue" indicator.
• Linked account — optional, for reference only (Goals do not move money — they're a savings plan, not a separate sub-account).
• Notes — context for your future self.

Goal Lifecycle

• Active — the default state while you're still contributing.
• Completed — set automatically the moment a contribution makes current_amount >= target_amount. The system fires a "goal achieved" notification.
• Cancelled — manually set from the edit screen. Only active goals can be cancelled; completed ones cannot.
• Overdue badge — shown when a goal is still active and its target date has passed.

Bills & Recurring

Recurring Bills

Bills are repeating income or expenses (rent, salary, Netflix, mortgage). Each bill knows its next due date; recording a payment writes a real transaction, updates the account balance, and rolls the bill forward to its next due date — automatically.

Fields You Can Set

• Name & type — Income or Expense.
• Account & category — where the money lands / leaves and how to classify it.
• Amount — the recurring value.
• Frequency — Daily, Weekly, Bi-weekly, Monthly, Quarterly, or Yearly.
• Start date — when the bill begins; the first next due date is calculated from this.
• End date — optional cap; the bill auto-deactivates once the next due date passes this.
• Auto-record — reserved for future automation (currently records are manual).
• Description — optional notes.

The "Record" Action

When you click Record on a bill:

1. A new Transaction is created with the bill's type, amount, account, and current next_due_date, with is_recurring=true and a back-reference (bill_id) to this bill.
2. The linked account's balance is updated (income adds, expense subtracts).
3. next_due_date is advanced by the bill's frequency via advanceDueDate().
4. If the new next_due_date would pass end_date, the bill auto-deactivates.

Debts

Debt Tracking

Track money you've borrowed (you owe someone) or lent (someone owes you). Recording a debt automatically moves the principal into or out of an account; logging repayments chips away at the balance until the debt is fully settled.

Fields You Can Set

• Type — Borrowed (you received money) or Lent (you gave money out).
• Name, contact name, contact phone — who the other party is.
• Total amount — the principal.
• Interest rate — stored for reference; no auto-accrual.
• Due date — optional; drives the "overdue" status.
• Account — where the principal lands (Borrowed) or leaves from (Lent).
• Notes — context.

How the Principal Works

Creating a debt is more than a record — it creates a real transaction:

• Borrowed debts create an income transaction (the money lands in your account).
• Lent debts create an expense transaction (the money leaves your account).
• The transaction ID is stored on the debt as principal_transaction_id so the system can reverse it later if the debt is edited or deleted.

Repayments

• Each repayment creates its own transaction in the opposite direction to the principal — paying back a borrowed debt is an expense; receiving repayment on a lent debt is income.
• paid_amount on the debt is incremented after each repayment; status is recalculated immediately.
• Deleting a repayment reverses both the transaction and the paid_amount.
• Validation prevents repayments that would exceed the remaining balance.

Status Lifecycle

• Active — still outstanding.
• Paid — paid_amount >= total_amount (auto-set).
• Overdue — past due date and not yet paid (auto-set).
• Cancelled — only set manually; reverses all related transactions.

Reports

Five report types help you understand your finances:

• Income vs Expense
• Category Breakdown
• Account Statement
• Cash Flow
• Budget Report

Income vs Expense

Side-by-side comparison of total income and total expenses for any period. Spot months where spending exceeded earnings at a glance.

Category Breakdown

See exactly where money is going — a pie or bar chart grouped by category. Drill down by month, quarter or custom range.

Account Statement

A full ledger view of one account — opening balance, every transaction, and running balance. Export as CSV for reconciliation.

Cash Flow

Monthly cash-flow waterfall — how much came in, went out, and what was left. Identifies seasonal patterns in your finances.

Budget Report

Compare budgeted vs actual spending per category. Color-coded status shows on-track, warning (80 %+) and exceeded (100 %+) budgets.

Subscription

My Plan

See your current plan, renewal date, and feature limits. Upgrade, downgrade, or cancel from one screen.

Billing

Billing History

Download invoices for every successful payment. Filter by date or status.

Notifications

In-App Notifications

Stay informed about bill reminders, budget alerts, goal milestones, and team activity. Mark items read or clear all.

User Settings

Changelog

v1.0.0 — Initial release

• Admin: users, plans, subscriptions, payments, reports, settings
• User: dashboard, workspaces, accounts, transactions, budgets, goals, bills, debts, reports
• Multi-workspace support with role-based permissions
• Light + dark mode dashboard

Support

Need help? Reach out through any of these channels:

• Author: Codericks
• Email: codericks.envato@gmail.com
• Documentation: this guide (you're reading it!)
• Issue tracker: via your CodeCanyon item comments

php artisan about
php artisan migrate --seed
php artisan storage:link

Common artisan commands you may need while troubleshooting.