Skip to content

serveshjain/Minting1

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

1 Commit
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

Minting - Indian Portfolio Tracker

Professional portfolio management system for Indian markets with advanced leverage tracking, dual P&L display, and real-time analytics.

Live Demo License: MIT Netlify Status

๐ŸŽฏ What is Minting?

Minting is a modern portfolio tracker designed specifically for Indian traders who need advanced features like leverage tracking, dual P&L calculations, and real-time analytics across multiple market segments.

Key Differentiators:

  • ๐Ÿ’ช Position-level leverage tracking (Fixed โ‚น or Multiplier)
  • ๐Ÿ“Š Dual P&L display (Stock performance vs. Actual returns)
  • ๐ŸŽฒ Mock live pricing for offline testing
  • ๐Ÿ“ˆ Portfolio health scores (4 metrics)
  • ๐ŸŽจ Beautiful dark theme with smooth animations

โœจ Features

๐Ÿ“Š Multi-Segment Support

  • Cash - Equity delivery trading
  • Futures - F&O with automatic lot size handling
  • Options - CE/PE with strike prices and expiry
  • MCX - Commodities (Gold, Silver, Crude, etc.)

๐Ÿ’ช Advanced Leverage Tracking

Track leverage two ways:

  1. Fixed Amount: "I deployed โ‚น5 lakhs" โ†’ Auto-calculates multiplier
  2. Multiplier: "I took 5x leverage" โ†’ Amplifies P&L automatically

๐Ÿ“ˆ Dual P&L System

See both what the stock did AND what you actually made:

Stock moved: +22.93% (Actual Performance)
You made: +121.89% (With 5.3x Leverage) ๐Ÿš€

๐ŸŽฒ Mock Live Pricing

  • Test offline with realistic price movements
  • Auto-refresh every 1 minute during market hours
  • Toggle between mock and real Yahoo Finance API

๐Ÿ“Š Portfolio Analytics

  • Quality Score - Segment diversity & performance
  • Momentum Score - Percentage of profitable positions
  • Diversification Score - Concentration risk analysis
  • Risk Score - Leverage exposure assessment

๐Ÿ“ˆ Charts & Visualizations

  • Portfolio value trend (30-day line chart)
  • Segment allocation (pie chart)
  • Smart recommendations based on portfolio analysis

๐Ÿš€ Quick Start

Local Testing (No Installation Required!)

  1. Clone the repository:

    git clone https://github.com/serveshjain/Minting.git
    cd Minting
  2. Open in browser:

    # Just open index.html in your browser
    open index.html  # Mac
    start index.html # Windows
  3. Start using:

    • Click "Add Position"
    • Enter your trades
    • Watch mock prices update!

No npm install, no build process - just open and use! โœจ


๐ŸŒ Deploy to Netlify

One-Click Deploy

Deploy to Netlify

Manual Deploy

  1. Connect to Netlify:

    • Go to netlify.com
    • Click "New site from Git"
    • Choose GitHub โ†’ Select this repository
  2. Configure:

    • Build command: (leave empty)
    • Publish directory: .
    • Functions directory: netlify/functions
  3. Deploy!

    • Every push to main = auto-deploy
    • Get your live URL
  4. Enable Real Pricing:

    • In index.html, change line 133:
    const [useMockPricing, setUseMockPricing] = useState(false);
    //                                                    โ†‘ false for production

๐Ÿ“– Documentation

Complete documentation available in /docs:


๐ŸŽจ Screenshots

Open Positions

Portfolio overview with dual P&L display

Analytics Dashboard

Health scores, charts, and recommendations

Add Position Modal

Leverage and charges tracking


๐Ÿ› ๏ธ Tech Stack

  • Frontend: React 18 (CDN) + Babel
  • Charts: Recharts
  • Styling: Custom CSS with CSS Variables
  • Backend: Netlify Functions (Serverless)
  • API: Yahoo Finance
  • Storage: localStorage (Client-side)
  • Deployment: Netlify (Free tier)

No build process required! Everything runs directly in the browser.


๐Ÿ“Š Example: Dual P&L in Action

Trade: NIFTY 25000 CE
Entry: โ‚น150.50
Exit: โ‚น185.00
Capital: โ‚น2,00,000
Leverage: 5.32x

Results:
โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
โ”‚ Actual Gain (Option Movement)      โ”‚
โ”‚ +22.93% โœ…                          โ”‚
โ”‚ Raw P&L: โ‚น8,625                    โ”‚
โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜

โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
โ”‚ Leveraged Returns (Your Capital)   โ”‚
โ”‚ +121.99% ๐Ÿš€                         โ”‚
โ”‚ Net P&L: โ‚น45,885                   โ”‚
โ”‚ ROI on โ‚น2L = 121.99%               โ”‚
โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜

๐Ÿ—‚๏ธ Project Structure

Minting/
โ”œโ”€โ”€ index.html              # Main application (Phase 3)
โ”œโ”€โ”€ netlify.toml           # Netlify configuration
โ”œโ”€โ”€ netlify/
โ”‚   โ””โ”€โ”€ functions/
โ”‚       โ””โ”€โ”€ getLivePrice.js # Yahoo Finance API wrapper
โ”œโ”€โ”€ docs/                  # Complete documentation
โ”‚   โ”œโ”€โ”€ 01-project-overview.md
โ”‚   โ”œโ”€โ”€ 02-data-models.md
โ”‚   โ”œโ”€โ”€ 03-pnl-calculations.md
โ”‚   โ”œโ”€โ”€ 04-ui-designs.md
โ”‚   โ”œโ”€โ”€ 05-implementation-plan.md
โ”‚   โ””โ”€โ”€ 06-user-requirements.md
โ””โ”€โ”€ README.md             # This file

๐ŸŽฏ Key Features Breakdown

Position Management

  • โœ… Add positions (all segments)
  • โœ… Edit prices manually
  • โœ… Close positions with P&L summary
  • โœ… Delete positions
  • โœ… Segment filtering

Pricing

  • โœ… Mock live pricing (offline testing)
  • โœ… Auto-refresh (1-minute intervals)
  • โœ… Manual refresh
  • โœ… Market hours detection
  • โœ… Real Yahoo Finance API (when deployed)

Analytics

  • โœ… 4 portfolio health scores
  • โœ… Portfolio value chart (30 days)
  • โœ… Segment allocation chart
  • โœ… Smart recommendations
  • โœ… Historical tracking

Advanced Features

  • โœ… Leverage tracking (Fixed โ‚น / Multiplier x)
  • โœ… Charges tracking (Fixed โ‚น / Percentage %)
  • โœ… Dual P&L display
  • โœ… Lot size handling
  • โœ… Holding period calculation

๐Ÿš€ Roadmap

โœ… Phase 1 + 2 + 3 (Complete)

  • Core position management
  • Leverage tracking
  • Dual P&L calculations
  • Mock live pricing
  • Portfolio analytics
  • Charts and visualizations

โณ Phase 4 (Upcoming)

  • Data export (CSV/Excel)
  • Advanced filtering
  • Price alerts
  • Tax reporting (STCG/LTCG)
  • Broker statement import

๐Ÿ”ฎ Future Enhancements

  • Multiple portfolios
  • Mobile app
  • Real-time notifications
  • Social features

๐Ÿค Contributing

Contributions are welcome! Here's how:

  1. Fork the repository
  2. Create a feature branch: git checkout -b feature/amazing-feature
  3. Commit changes: git commit -m 'Add amazing feature'
  4. Push to branch: git push origin feature/amazing-feature
  5. Open a Pull Request

Development Guidelines

  • Follow existing code structure
  • Test thoroughly with mock pricing
  • Update documentation
  • Use meaningful commit messages

๐Ÿ“ License

This project is licensed under the MIT License - see the LICENSE file for details.


๐Ÿ™ Acknowledgments

  • Yahoo Finance for price data API
  • Netlify for free hosting and serverless functions
  • React Team for an amazing framework
  • Recharts for beautiful charts
  • Indian Trading Community for inspiration

๐Ÿ“ง Contact

Developer: Servesh Jain
GitHub: @serveshjain
Repository: Minting


โš–๏ธ Disclaimer

Important: This is a portfolio tracking tool, not investment advice.

  • Past performance doesn't guarantee future results
  • Trading involves risk - you can lose money
  • Do your own research before trading
  • Leverage magnifies both gains AND losses
  • Use at your own risk

This tool is for tracking purposes only. Always verify with your broker statements.


๐ŸŒŸ Show Your Support

If you find Minting useful:

  • โญ Star this repository
  • ๐Ÿฆ Share with fellow traders
  • ๐Ÿ› Report bugs or issues
  • ๐Ÿ’ก Suggest new features
  • ๐Ÿค Contribute code

๐Ÿ“ˆ Stats

GitHub stars GitHub forks GitHub issues GitHub last commit


Built with โค๏ธ for Indian traders
Made in India ๐Ÿ‡ฎ๐Ÿ‡ณ | For Indian Markets ๐Ÿ“Š | Open Source ๐Ÿ”“


Last Updated: January 29, 2026
Version: 3.0 (Phase 3 Complete)
Status: Production Ready ๐Ÿš€

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors