Changelog

• Drag-and-Drop Column Reordering: Customize your holdings table layout by dragging columns to rearrange them. Your custom layout is saved automatically, with a quick reset button to go back to default.
• Yield on Cost & Valuation (YoC/YoV): Added "Div Yield" tracking to holdings. See how much income your investments generate relative to what you paid (YoC) vs. what they are worth today (YoV).

• Planning Fund Browser Sorting: Made the "Sector Alignment" sorting option much more prominent and separate, making it easier to filter funds.
• Valuation Reliability & Speed: Optimized mutual fund historical valuation calculations for faster chart loading times and potential mid chart value dip fixes.

• Planning Fund Browser: Introduced a dedicated mutual fund search and browsing experience inside the Planning tab. Easily discover and filter funds based on their equity holdings, sector preferences, asset classes, fees, and historical performance.
• Positions Snapshot Import Mode: A new import option in the broker statement upload wizard that lets you initialize or overwrite current portfolio positions from a single statement snapshot.
• Auto Payout / Dividend Import Mode: Automatically identifies, processes, and tracks dividend payouts and bonus share distributions during broker statement imports, handling ex-dates, rounding entitlements, and integration directly into the portfolio.
• P&L Breakdown Chart Enhancements: Added a dedicated Dividends line to the main portfolio profit and loss breakdown chart, making total returns more transparent.

• Mobile Portfolio Page Enhancements:

  • Added full sorting capabilities to the portfolio holdings list on mobile.
  • Added a column selector (persisted to local storage) to customize which table columns are visible.
  • Added an "Asset Type" column (Stock, ETF, Mutual Fund, Gold, Silver, Forex) for better portfolio clarity.
  • Redesigned mobile cards and resolved overlapping UI elements on narrow screens.
• Broker Statement Review & Execution Wizard:

  • Redesigned the review modal with expandable rows, search/filtering of trade candidates, and wider layout space.
  • Added support for KTrade (Cash Book) and Arif Habib (Order History) brokerage statement parsers.
  • Added real-time gap analysis warnings to guide imports of missing historical trades.
  • Large statement imports are now divided into manageable chunks (250 items at a time) for more robust execution.
  • Added status monitoring and auto-retry controls for trade, dividend, and bonus processing.
• Planning & Screener UX:

  • Added a clear search button to the planning browser.
  • Sector options and preferences are loaded dynamically from the database.

• Fund Comparison Return Calculations: Fixed a bug where returns could appear inflated or throw division-by-zero errors when the portfolio's history was shorter than the selected timeframe.
• UI & Charts Polish: Fixed tooltip flickering on the P&L chart and resolved alignment issues across holdings tables.

• Broker Statement Import: Upload a PDF or image of any Pakistani brokerage account statement and let it automatically extract your trades. Review, edit, confirm, or reject each candidate before anything is executed. Supports SCS Trade, AHL, KASB, and other major brokers — with broker-specific parsing logic for higher accuracy.
• Zakat Auto-Calculation: Enable Zakat in portfolio settings to automatically deduct Zakat on eligible dividend income. A guided setup prompt walks you through the configuration.

• CSV Bulk Import — Overhaul:

  • Processing is now fully asynchronous (queue-backed), so large imports no longer time out
  • Real-time progress bar during import with throttled updates
  • Dividend rows now accept a Net Amount column as an alternative to Gross Amount
  • BonusPercentage is optional for STOCK_SPLIT rows — auto-computed from the split ratio
  • Duplicate dividend and bonus rows are detected and skipped automatically
  • One active import enforced per portfolio to prevent conflicting concurrent imports
  • Snapshot recalculation is deferred until after import, making large batches significantly faster
  • CSV template and in-app guide updated to cover dividend and bonus row types
  • Column-type annotation row added above headers for easier manual editing
• Unified Import Modal: CSV bulk import and broker statement upload are now consolidated into a single "Import Trades" modal.
• Bonus & Split Entry:

  • Manual bonus and split recording now available directly from the trade form
  • BonusPercentage auto-computes for splits when ratio columns are present
  • Broker statement parser now extracts bonus and split events alongside regular trades
  • Improved validation rejects non-numeric or malformed bonus quantities before submission
• Performance: Cash ledger recalculation is now deferred during bulk and batch trade execution, substantially reducing processing time for large imports.
• Reliability: All background workers now shut down cleanly on server restart, eliminating the risk of orphaned or stuck jobs after a deploy.
• Rate Limiting: System-level rate limits added to statement parsing endpoints to ensure fair usage and prevent overload during periods of heavy concurrent use.

• Broker Statement Modal: Fixed stale batch state when reopening the import modal after a previous session.
• Import Modal Error Messages: The import modal now correctly surfaces backend error messages instead of a generic failure notice.
• Portfolio Cache Invalidation: Fixed a stale-data pattern in portfolio and stock-allocation queries that could show outdated holdings after a trade.
• Optimistic UI Flicker: Fixed a status flicker in import and batch flows caused by premature optimistic state updates.

• MF Holdings Page: New dedicated page at /stocks/mutual-funds-holdings showing which equities are held across Pakistani mutual funds, with a fund-by-fund breakdown, sortable columns, and inline timeline expansion per stock.
• Stock Holdings Timeline: View how a stock's institutional ownership from mutual funds has evolved over time, accessible directly from the MF Holdings page.

• Fund Screener — Mobile UX Redesign:

  • AMC and fund type quick filters added to the top action bar
  • Column visibility selector: show or hide columns you care about
  • NAV validity date visible per fund — instantly spot funds with stale NAVs
  • 100K returns column added
  • Payout section renamed to "Dividends" for clarity
  • Data fetching migrated to SWR for faster, more consistent updates
  • Shariah compliance indicator added to mobile fund list rows
  • Sticky table header removed; table width increased for better horizontal scrolling
• MF Holdings — Desktop & Mobile Layout:

  • Desktop: 1:2 grid with compact summary sidebar and tabbed highlights panel
  • Mobile: row index and symbol columns are sticky with synced hover states; ticker-only display on narrow screens to maximise horizontal scroll space
• Watchlist Quick Preview: Expanded popover now shows NAV validity date; mobile filter bar decluttered.
• PWA: Install prompt fixed globally; install button is now conditional (only shown when the browser signals the app is installable); install guide page added; PWA marketing content refreshed.
• Portfolio Limit: Users with the Stocks feature enabled can now create one additional portfolio.

• Silver Position Identifier: Corrected an incorrect asset identifier for silver positions that caused data mismatches in holdings and valuations.
• MF Holdings Aggregation: Fixed incorrect aggregation semantics that could over- or under-count fund holdings.
• Fund Holding Category: Fixed category assignment for fund holdings.
• MF Holdings Sticky Columns: Synced hover highlight across sticky (index/symbol) and scrollable columns; added drop-shadow border for visual separation.

• Portfolio Sell Planning: The Planning tab now includes sell recommendations for overweight positions — see exactly how much to trim to reach your target allocation, with a visual allocation drift chart alongside it.

• Portfolio Charts:

  • Overview tab now uses a fixed 60-day window for a consistent at-a-glance snapshot
  • All other tabs (Returns, etc.) show full available history
  • Chart drag and zoom fixed
  • TWR (Time-Weighted Return) calculation updated
• Stock Detail Page: Added chart/table view toggle to the Financials and Payouts sections; Amount Invested sort added; chart and table views polished.
• Trade Forms: Submit buttons now correctly enable as soon as all required fields are valid across Stock, Mutual Fund, Cash, Dividend, and Bonus forms. Reconciliation and validation error messages improved for MF trades.
• Stock Trade Form: Tax preview updated to reflect the latest fee and tax calculation logic.
• Portfolio Switch: Switching between portfolios is faster and more reliable with no stale data carrying over.
• CPI / Inflation Calculations: Inflation period logic moved to the backend, ensuring consistent results across all clients and devices.

• Stock Trade Form: The full BUY and SELL workflow for PSX-listed stocks is now live. This is the core feature that turns FinHisaab into a complete equity portfolio tracker — record every trade with accurate fee and tax handling, and the rest of the portfolio updates automatically.

  • Stock search with fuzzy symbol lookup
  • Quantity and price entry with net cost preview
  • Complete fee breakdown: brokerage commission, sales tax (SST), and CGT
  • Tax filer / non-filer status warning before executing a SELL
  • Available units shown on the SELL form to prevent over-selling
  • Partial dividend funding: use a pending dividend credit as a funding source for a new BUY
  • Realized P&L, net proceeds, and effective cost-per-share shown immediately after a SELL
• Stock Portfolio Tracking: Actual holdings tracking for PSX stocks — not a calculator, but live positions driven by real trades you enter.

  • Holdings list with quantity, average cost, current value, unrealized P&L, and daily change
  • Full transaction history per position (buys, sells, dividends, bonuses)
  • Cost basis and average price auto-updated on every trade
  • Dividend entitlements automatically synced to positions on announcement
• Daily P&L Tab: Dedicated tab on the portfolio page showing today's intraday P&L across all stock positions, updated continuously.

• Net Deposits P&L (True Returns): Cash flow-based P&L that factors in all deposits and withdrawals to show your actual earned returns — not just the difference between cost and current price. Displayed alongside standard unrealized P&L.

• Per-Holding Analytics Tab: Every stock holding now has a dedicated analytics tab:

  • Long-term performance charts with 1Y and 3Y period support and compounding breakdowns
  • Dividend analytics: income history, yield-on-cost, and a full payout timeline
  • Holdings comparison: benchmark one position against others or your whole portfolio
• Benchmark Comparison on Portfolio Chart: Compare your portfolio against any Pakistani mutual fund or market index on the main performance chart. Base-100 indexed, toggleable, with a choice of comparison target.

• Dividend Reinvestment Tracking: Mark a dividend as reinvested into a stock purchase; partial dividend funding lets the dividend offset part of the cash needed for a BUY.

• Portfolio Allocation Composition Chart: Visual breakdown of your entire portfolio across individual holdings, sectors, and asset classes.

• Trader Analytics — Cash Impact: Shows the true total cash outflow of each trade inclusive of all fees and taxes, and tracks how trading costs compound over time.

• Demo Portfolio: Non-logged-in visitors can now explore a fully guided demo portfolio to experience the feature set before signing up.

• Sell Transaction View: Sell entries now show realized P&L, net amount after all deductions, and effective cost per share for a complete post-trade picture.
• Payouts Tab Restructured: Long-term dividend analytics consolidated into the dedicated Payouts tab, keeping individual holding pages focused on performance.
• Planning Tab — SIP Suggestions: Allocation suggestions now use actual holding data and run client-side for instant results.
• Portfolio Chart — Short-Period Guard: XIRR/MWR real-returns calculation hidden on short timeframes where the result is not statistically meaningful.
• Holdings Comparison: Your own portfolio added as a comparison target in the holdings comparison chart.
• Dividend Funding Indicator: Visual cue on the trade form when a dividend is being partially applied as a funding source.

• MWR Chart Blank: Fixed blank chart rendering in the Money-Weighted Return view on certain date ranges.
• CGT Transaction Warning: Added a contextual warning for sell trades that produce a CGT-liable event.
• Benchmark Chart Backfill: Fixed a rendering bug where gaps in the benchmark's historical data caused the chart series to display incorrectly.

• Fund Screener: Corrected column sequencing in the mutual fund screener table for better data organization.

• Mobile Compact Table View: Introduced a toggleable compact table view for Holdings and Transactions on mobile. Switch between detailed cards and a high-density, horizontally-scrollable table.
• Full Portfolio Sorting: All 11 columns in the portfolio holdings table (desktop and mobile compact) are now interactive. Sort by Value, P&L, Yield, or any other metric.

• View Persistence: Your preference for "Compact Table" vs "Detailed List" is now saved locally and persists across browser sessions.
• UI Optimization: Refined column widths and sticky headers in the compact view for a smoother mobile experience.

• Advanced Yield Tracking:

  • Integrated TTM (Trailing Twelve Months) yield analysis in the stock performance calculator.
  • Added yield-on-cost indicators to the dividend analysis tab for long-term holders.
• Valuation Transparency: Added "Last Valuation Date" to holding detail pages to clarify the freshness of market data.
• Investment Cost Tooltips: Added informative tooltips to portfolio summary cards to explain cost and average price calculation methodologies.

• UX Polish: Optimized dividend announcement buttons and refined individual stock displays for better readability.
• Chart Visuals: Improved hover interactions and visual margins on all portfolio charts.

• Trade Forms: Resolved a bug in the mutual fund trade form amount validation.
• Value Charts: Fixed an issue where chart tooltips would occasionally stick or display incorrect data points on hover.

• WhatsApp Integration: Added a quick-contact/share button to the portfolio page for easier communication and sharing.
• Dividend List Insights:

  • Added "Yield" columns to the Upcoming Dividends and Corporate Actions lists.
  • Enabled sorting by yield on mobile for quicker identification of high-dividend opportunities.

• Portfolio Visuals: The "Invested" capital line on charts is now dashed, making it easier to distinguish from the total value line.
• Mobile Detail Pages: Significant refinement of margins and alignment across mobile-specific detail layouts.

• Upcoming Corporate Actions: Launched a new homepage section featuring horizontally scrollable carousels for Upcoming Dividends and Upcoming Bonuses/Splits.
• Market Data Integration: Dividend and Bonus lists now include real-time stock prices, daily price changes, and percentage shifts.
• Enhanced Filtering & Sorting:

  • Added a "Show Latest Announcements" toggle to filter for recent corporate actions.
  • New "Highest Amount/Percent" filter for prioritizing large payouts.
  • Client-side sorting capabilities for quick list navigation.
• Portfolio Tracking Enhancements:

  • Added "Today's PnL" tracking for Commodity and Forex positions.

• Mobile UX Optimization:

  • Redesigned FIPI-LIPI dashboard for mobile, including compact summary cards and optimized tab navigation.
  • Refined mobile card layouts for corporate actions to clearly display price and ex-date information.
  • Added "Days Remaining" markers to dividends and bonuses for easier tracking.
• FIPI-LIPI Charts:

  • Updated trend charts to show a 60-day historical lookback.
  • Optimized chart margins, axis labels, and bar widths for better readability across all screen sizes.

• Gold Calculator Features: Introduced quick-calculation presets (10g, 1 Tola, 10 Tola) & persistence for user inputs.
• Portfolio Invested Toggle: Added a persistent "Invested" line toggle on portfolio charts to easily compare total value against invested capital.
• Portfolio Chart Tooltips: Implementation of interactive, multi-series tooltips on portfolio charts, optimized for both desktop (hover) and mobile (tap-to-stick) interactions.

• Trading: Resolved an issue where BUY trades for commodities and forex were failing due to incorrect amount calculations and handling.

• Gold Value Calculator: Launched a new tool on the gold page for calculating total gold value based on current market rates.
• Asset Class Comparison: Integrated comprehensive performance comparisons with key asset classes on both the Inflation and Gold calculator pages.
• Inflation Historical Data: Added an interactive historical yearly returns chart to the inflation page with support for fetching of historical inflation data up until 1960.

• Portfolio Readability & UX: Significant optimization of the portfolio section for enhanced readability and a more premium user experience, including refined summary cards and full-width responsive charts on mobile.
• Inflation Summary Reports: Refined the automated inflation summary text for better accuracy and more professional descriptors of inflationary trends.

• Stock Portfolio Dividend Analysis: Added a dedicated Dividends tab focused on dividends received, with historical income, yield, concentration, and DPS analysis for selected holdings.
• Mutual Fund Composition Comparison: Detailed side-by-side comparison of sector allocation and top equity holdings across multiple funds with historical snapshot support.
• Composition Comparison Visuals: Interactive visual analysis suite for mutual fund composition, including Grouped Bar charts, Dumbbell Plots (Gap Analysis), Portfolio Treemaps, and Difference (Delta) charts.

• PSX Dividend/Bonus Handling: Updated stock performance calculations to better align same-day dividend and bonus/split handling with PSX ex-price methodology while preserving the existing post-tax bonus entitlement treatment for investor returns.

• FIPI-LIPI Daily Data Dashboard: Comprehensive tracking of Foreign and Local Investors Portfolio Investment (PSX) with segment-level filtering (Equity, Debt, All) and historical flow trends.

• Sector Allocation Tab: Added a dedicated sector allocation view in the stock portfolio calculator for a clearer breakdown of your portfolio mix.
• Allocation by Share Count: You can now enter allocations using share counts, making setup quicker if you already know your quantities.
• Chart Experience Updates: Improved both portfolio and individual stock charts for a cleaner, easier-to-read performance view.

• Mutual Fund Composition History: Multi-month view for sector allocation and top equity holdings on mutual fund detail pages.
• New Funds Added: Added several new mutual funds to the platform like Atlas Islamic Energy Fund, Atlas Islamic Building Material Fund, Al Habib Islamic Money Market Fund etc

• Portfolio Reset & Delete: New capabilities to completely reset or permanently delete portfolios and all associated data.
• Danger Zone: Added a dedicated management section in Portfolio Settings for destructive actions with safety confirmations.
• Silver Price Tracking: Live silver rates in Pakistan with historical charts (5Y) and performance analysis.
• US Dollar Price Tracking: Live USD/PKR exchange rates in Pakistan with historical charts (15Y) and performance analysis.

• Position Deletion System: Delete commodities, forex, and mutual fund positions from your portfolio
• Stock Portfolio Returns Tool: Comprehensive returns calculation with CAGR, base-100 indexing, and tax calculations
• Active/Inactive Position Filters: Filter holdings by active or inactive status

• Portfolio Transactions: Missing transactions on holding detail page

• Commodity & Forex Trades: Add trades for commodities and forex
• Watchlist: Add mutual funds to watchlist
• Inflation Calculator: Calculate buying power of PKR over time
• Leaderboard: Add leaderboard for mutual funds

• Holding List UX: Added Buy/Sell button to holding list
• Trade Form: Added available units from holding details

[1.0.0] - 2025-XX-XX

• Initial release of FinHisaab
• Mutual funds screener with comprehensive filtering
• Stock portfolio tracking with P&L calculations
• SIP calculator for investment planning
• Real-time NAV updates and performance tracking
• User authentication with Google OAuth