MeroShare Nepal Automation Tool 🇳🇵

An automated tool for applying to IPO/FPO shares on MeroShare Nepal using Cypress E2E testing framework.

⚠️ Disclaimer

This tool is for educational purposes only. Use it responsibly and in accordance with MeroShare's terms of service. The authors are not responsible for any misuse or consequences arising from the use of this tool.

🚀 Features

• Multi-user Support: Apply for shares using multiple user accounts
• Automated Form Filling: Automatically fills application forms
• Bank Integration: Supports multiple banks and BOID selection
• Error Handling: Robust error handling and logging
• Configurable: Easy configuration through JSON files
• Open Source: MIT licensed and community-driven

📋 Prerequisites

• Node.js (version 16 or higher)
• npm or yarn package manager
• Valid MeroShare accounts
• Valid bank accounts with BOID numbers

🛠️ Installation

1. Clone the repository:

git clone https://github.com/your-username/meroshare-automation.git
cd meroshare-automation

2. Install dependencies:

npm install

3. Set up configuration files:

# Copy example files and configure them
cp cypress/fixtures/meroUser_example.json cypress/fixtures/meroUser.json
cp cypress/fixtures/companyDetails_example.json cypress/fixtures/companyDetails.json

⚙️ Configuration

User Configuration

Edit cypress/fixtures/meroUser.json with your user details:

[
  {
    "name": "Your Name",
    "bank": "YOUR BANK LIMITED (CODE)",
    "user": "your_username",
    "pwd": "your_password",
    "crnNumber": "your_crn_or_boid",
    "appliedKitta": "10",
    "selectBank": "YOUR BANK LTD.",
    "transactionPIN": "your_pin"
  }
]

Company Configuration

Edit cypress/fixtures/companyDetails.json:

{
  "companyName": "Company Name Ltd."
}

🏃‍♂️ Usage

Development Mode (Interactive)

npm run cy:open

Headless Mode (CI/CD)

npm run cy:run

Run Specific Test

npm run test:meroshare

📁 Project Structure

├── cypress/
│   ├── e2e/
│   │   └── meroshare/
│   │       └── merosharelogin.cy.js     # Main test file
│   ├── fixtures/
│   │   ├── meroUser.json                # User configurations
│   │   ├── meroUser_example.json        # Example user config
│   │   ├── companyDetails.json          # Company details
│   │   └── companyDetails_example.json  # Example company config
│   ├── support/
│   │   ├── commands.js                  # Custom Cypress commands
│   │   ├── e2e.js                      # Support file
│   │   └── utils.js                    # Utility functions
│   └── cypress.config.js               # Cypress configuration
├── package.json
└── README.md

🔧 Configuration Options

User Fields

Field	Description	Required
name	Full name as registered	✅
bank	Bank name with code	✅
user	MeroShare username	✅
pwd	MeroShare password	✅
crnNumber	CRN or BOID number	✅
appliedKitta	Number of shares to apply	✅
selectBank	Bank for payment	✅
transactionPIN	Transaction PIN	✅

Supported Banks

• Kumari Bank Limited
• NIC Asia Bank Limited
• Global IME Bank Limited
• And many more...

🧪 Testing

Run the test suite:

npm test

Run with specific browser:

npx cypress run --browser chrome

🤝 Contributing

We welcome contributions! Please see our Contributing Guidelines for details.

Development Setup

1. Fork the repository
2. Create a feature branch: git checkout -b feature/amazing-feature
3. Make your changes
4. Run tests: npm test
5. Commit changes: git commit -m 'Add amazing feature'
6. Push to branch: git push origin feature/amazing-feature
7. Submit a pull request

Coding Standards

• Use meaningful variable names
• Add comments for complex logic
• Follow existing code style
• Write tests for new features

📝 Changelog

v1.0.0

• Initial release
• Multi-user support
• Basic IPO application automation
• Bank integration

⚖️ License

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

🙏 Acknowledgments

• Cypress.io for the amazing testing framework
• MeroShare Nepal for providing the platform
• Contributors and the community

📞 Support

If you encounter any issues or have questions:

1. Check the Issues page
2. Create a new issue with detailed information
3. Join our community discussions

⭐ Star History

If this project helped you, please consider giving it a star! ⭐

---

Made with ❤️ for the Nepalese investment community