{"id":30195798,"url":"https://github.com/bilalmohib/aussievaultbrowser","last_synced_at":"2026-04-13T01:35:46.194Z","repository":{"id":308559700,"uuid":"1004868347","full_name":"bilalmohib/AussieVaultBrowser","owner":"bilalmohib","description":"A secure, Electron-based remote browser for accessing SharePoint PDFs with vault-managed credentials, user role control, and enforced Australian VPN routing. Includes a Next.js + Supabase admin panel for managing user access levels and configuration.","archived":false,"fork":false,"pushed_at":"2025-08-06T14:50:33.000Z","size":2959,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-08-06T16:41:08.040Z","etag":null,"topics":["australia","electron-app","electron-reactjs","electronjs","sharepoint","tailwindcss","vpn"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bilalmohib.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-06-19T09:55:11.000Z","updated_at":"2025-08-06T09:26:11.000Z","dependencies_parsed_at":"2025-08-06T16:41:15.473Z","dependency_job_id":"c23bc154-cb52-4216-b014-a86f2fd13c79","html_url":"https://github.com/bilalmohib/AussieVaultBrowser","commit_stats":null,"previous_names":["bilalmohib/aussievaultbrowser"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/bilalmohib/AussieVaultBrowser","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bilalmohib%2FAussieVaultBrowser","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bilalmohib%2FAussieVaultBrowser/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bilalmohib%2FAussieVaultBrowser/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bilalmohib%2FAussieVaultBrowser/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bilalmohib","download_url":"https://codeload.github.com/bilalmohib/AussieVaultBrowser/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bilalmohib%2FAussieVaultBrowser/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":270183606,"owners_count":24541341,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-13T02:00:09.904Z","response_time":66,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["australia","electron-app","electron-reactjs","electronjs","sharepoint","tailwindcss","vpn"],"created_at":"2025-08-13T05:01:08.508Z","updated_at":"2026-04-13T01:35:46.158Z","avatar_url":"https://github.com/bilalmohib.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🇦🇺 Aussie Vault Browser\n\nA secure, privacy-focused browser application with VPN capabilities and 1Password integration, specifically designed for Australian users.\n\n## ✨ Features\n\n- **🔐 Enhanced Security**: Built-in VPN protection and secure browsing\n- **🔑 1Password Integration**: Seamless password management\n- **🇦🇺 Australian Focus**: Optimized for Australian users and services\n- **⚡ Fast Performance**: Electron-based with modern web technologies\n- **🎨 Modern UI**: Clean, intuitive interface built with React and Tailwind CSS\n\n## 🚀 Quick Installation\n\n### macOS - One-Command Installation\n\n**Homebrew (Recommended):**\n```bash\nbrew install --cask bilalmohib/aussievault/aussie-vault-browser\n```\n\n**Curl Installer:**\n```bash\ncurl -fsSL https://raw.githubusercontent.com/bilalmohib/AussieVaultBrowser/main/install-aussie-vault.sh | bash\n```\n\n**Alternative (Two-step Homebrew):**\n```bash\nbrew tap bilalmohib/aussievault\nbrew install --cask aussie-vault-browser\n```\n\n### Manual Download\n\nDownload the latest release from [GitHub Releases](https://github.com/bilalmohib/AussieVaultBrowser/releases)\n\n- **macOS**: Download `.dmg` file\n- **Windows**: Download `.exe` installer  \n- **Linux**: Download `.deb` or `.rpm` package\n\n## 🔧 Development\n\n### Prerequisites\n\n- Node.js 18+ \n- npm or yarn\n- Python 3.x (for native modules)\n\n### Setup\n\n```bash\n# Clone the repository\ngit clone https://github.com/bilalmohib/AussieVaultBrowser.git\ncd AussieVaultBrowser\n\n# Install dependencies\nnpm install\n\n# Start development server\nnpm run dev\n\n# Build for production\nnpm run build\n\n# Package for current platform\nnpm run make\n\n# Package for all platforms\nnpm run make:all\n```\n\n### Release Process\n\n```bash\n# Complete release with Homebrew publishing\nnpm run release:homebrew\n\n# Or update just the Homebrew formula\nnpm run update:homebrew\n```\n\n## 🚀 Release Management\n\n### Automated Release Process\n\nThis project includes automated scripts to build and publish releases to the public repository while keeping the source code private.\n\n#### Quick Release Commands\n\n```bash\n# Build and release with version bump\nnpm run release:version [version]\n\n# Build and release current version\nnpm run release\n\n# Quick build and release (no prompts)\nnpm run release:quick\n```\n\n#### Manual Release Process\n\n1. **Update Version** (if needed):\n   ```bash\n   npm version 1.0.2 --no-git-tag-version\n   ```\n\n2. **Run Release Script**:\n   ```bash\n   ./scripts/publish-release.sh\n   ```\n\n3. **Complete GitHub Release**:\n   - Go to: https://github.com/bilalmohib/aussie-vault-browser-releases/releases\n   - Edit the created release\n   - Upload the DMG file\n   - Publish the release\n\n#### Installation for Users\n\nOnce released, users can install via Homebrew:\n\n```bash\nbrew install --cask bilalmohib/aussievault/aussie-vault-browser\n```\n\n### Repository Structure\n\n- **Private Repo** (`AussieVaultBrowser/`): Contains source code (this repository)\n- **Public Releases** (`aussie-vault-browser-releases/`): Contains releases only\n- **Homebrew Tap** (`homebrew-aussievault/`): Contains Homebrew cask formula\n\n## 📋 Admin Dashboard\n\nAccess the admin dashboard to manage users and monitor activity:\n\n```bash\ncd admin-aussie-vault-browser\nnpm install\nnpm run dev\n```\n\nFeatures:\n- User management with access levels\n- Session monitoring  \n- Security event tracking\n- VPN connection analytics\n- Real-time activity monitoring\n\n## 🛠️ Configuration\n\n### Environment Variables\n\nCreate a `.env` file in the project root:\n\n```bash\n# VPN Configuration\nVPN_PROVIDER=wireguard\nVPN_SERVER_REGION=australia\nVPN_AUTO_CONNECT=true\n\n# Security Settings  \nSECURITY_HTTPS_ONLY=true\nSECURITY_BLOCK_DOWNLOADS=false\nSECURITY_FAIL_CLOSED_VPN=true\n\n# Database (for admin dashboard)\nSUPABASE_URL=your_supabase_url\nSUPABASE_ANON_KEY=your_supabase_key\n\n# Authentication\nCLERK_PUBLISHABLE_KEY=your_clerk_key\nCLERK_SECRET_KEY=your_clerk_secret\n```\n\n### Access Levels\n\n- **Level 1**: Restricted access to approved sites only\n- **Level 2**: Manager access with additional permissions  \n- **Level 3**: Full access to all features\n\n## 🔐 Security Features\n\n- **Sandboxed Browsing**: Isolated browser environment\n- **VPN Enforcement**: Automatic VPN connection for secure browsing\n- **Content Filtering**: Block malicious sites and downloads\n- **Session Management**: Secure session handling and monitoring\n- **Audit Logging**: Complete activity logging for compliance\n\n## 🌐 VPN Setup\n\nThe browser includes built-in VPN support for Australian servers:\n\n1. **WireGuard Configuration**: Automatic setup for Australian endpoints\n2. **Connection Monitoring**: Real-time VPN status and failover\n3. **Geo-Blocking**: Ensure Australian IP addresses\n4. **Speed Optimization**: Optimized for Australian network infrastructure\n\n## 📱 Browser Features\n\n- **Secure Downloads**: Controlled download management with scanning\n- **Password Integration**: Native 1Password extension support  \n- **Context Menus**: Right-click to save pages as PDF\n- **Session Persistence**: Secure session storage and recovery\n- **Multi-Window**: Support for multiple browser windows\n\n## 🏢 Enterprise Deployment\n\n### System Requirements\n\n- **macOS**: 10.15+ (Catalina or later)\n- **Windows**: Windows 10/11\n- **Linux**: Ubuntu 18.04+, CentOS 7+\n- **RAM**: 4GB minimum, 8GB recommended\n- **Storage**: 500MB for application + data\n\n### Deployment Options\n\n1. **Homebrew** (macOS): Centralized package management\n2. **MSI Installer** (Windows): Group Policy deployment\n3. **DEB/RPM Packages** (Linux): Repository-based distribution\n4. **Docker**: Containerized deployment option\n\n## 📊 Analytics \u0026 Monitoring\n\nThe admin dashboard provides comprehensive analytics:\n\n- User session tracking\n- VPN connection statistics  \n- Security event monitoring\n- Download and navigation logs\n- Real-time system health\n\n## 🤝 Contributing\n\nWe welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for details.\n\n### Development Workflow\n\n1. Fork the repository\n2. Create a feature branch\n3. Make your changes\n4. Add tests if applicable  \n5. Submit a pull request\n\n## 📚 Documentation\n\n- [Admin Panel Setup](admin-aussie-vault-browser/README.md)\n- [VPN Configuration](docs/vpn-setup.md)\n- [1Password Integration](docs/1password-setup.md)\n- [Homebrew Publishing](HOMEBREW_SETUP.md)\n\n## 🐛 Bug Reports\n\nFound a bug? Please [open an issue](https://github.com/bilalmohib/AussieVaultBrowser/issues) with:\n\n- Operating system and version\n- Browser version\n- Steps to reproduce\n- Expected vs actual behavior\n- Screenshots if applicable\n\n## 📄 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## 🙏 Acknowledgments\n\n- Built with [Electron](https://www.electronjs.org/)\n- VPN powered by [WireGuard](https://www.wireguard.com/) \n- Password management via [1Password](https://1password.com/)\n- UI components from [Tailwind CSS](https://tailwindcss.com/)\n\n---\n\nMade with ❤️ in Australia 🇦🇺\n\nFor support, please contact [support@aussievault.com](mailto:support@aussievault.com)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbilalmohib%2Faussievaultbrowser","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbilalmohib%2Faussievaultbrowser","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbilalmohib%2Faussievaultbrowser/lists"}