https://github.com/loftwah/bogan_hustler
Bogan Hustler. A modern day and Australian take on the old drugwars/dopewars game. For educational purposes only.
https://github.com/loftwah/bogan_hustler
bun game tailwindcss typescript vite vitest
Last synced: 8 months ago
JSON representation
Bogan Hustler. A modern day and Australian take on the old drugwars/dopewars game. For educational purposes only.
- Host: GitHub
- URL: https://github.com/loftwah/bogan_hustler
- Owner: loftwah
- License: mit
- Created: 2025-02-20T04:41:26.000Z (8 months ago)
- Default Branch: main
- Last Pushed: 2025-02-28T07:30:46.000Z (8 months ago)
- Last Synced: 2025-02-28T14:29:35.236Z (8 months ago)
- Topics: bun, game, tailwindcss, typescript, vite, vitest
- Language: TypeScript
- Homepage: https://boganhustler.deanlofts.xyz/
- Size: 42.9 MB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 🦘 Bogan Hustler
Your Underground Empire Awaits in the Land Down Under 🇦🇺
[](https://opensource.org/licenses/MIT)
[](https://reactjs.org/)
[](https://www.typescriptlang.rg/)
[](https://vitejs.dev/)
[](https://tailwindcss.com/)
## 🎮 Play Now
[Play Bogan Hustler](https://boganhustler.deanlofts.xyz)
## 📖 About
Bogan Hustler is an Australian-themed trading game where you build your underground empire. Buy low, sell high, and navigate the streets of various Australian locations while avoiding the authorities and managing your reputation.
### 🌟 Features
- **Dynamic Market System**: Prices fluctuate based on supply, demand, and market events
- **Multiple Locations**: Travel across different Australian cities and regions
- **Reputation System**: Build your street cred to unlock better prices and opportunities
- **Inventory Management**: Strategically manage your limited cargo space
- **Random Events**: React to unexpected situations that can make or break your empire
- **Family-Friendly Mode**: Toggle between adult and family-friendly content
- **Responsive Design**: Play seamlessly on desktop or mobile devices
- **Dynamic Combat System**: Engage in fights with different types of opponents, each with unique abilities and strategies
## 🚀 Getting Started
### Prerequisites
- Node.js (v18 or higher)
- Bun (recommended) or npm
### Installation
```bash
# Clone the repository
git clone https://github.com/loftwah/bogan_hustler.git
# Navigate to project directory
cd bogan_hustler
# Install dependencies
bun install
# or
npm install
# Start development server
bun dev
# or
npm run dev
```
## 🎯 Game Objectives
1. Start with limited cash and build your empire
2. Navigate market fluctuations to maximize profits
3. Manage your reputation and avoid police attention
4. Upgrade your capabilities:
- Increase inventory space
- Improve police evasion
- Enhance market intelligence
## 🎮 Controls
- **Mouse/Touch**: Navigate menus and make trades
- **Keyboard Shortcuts**:
- `I`: Toggle inventory
- `M`: Open market screen
## 🛠️ Tech Stack
- **Frontend**: React + TypeScript
- **State Management**: Redux Toolkit
- **Styling**: TailwindCSS
- **Build Tool**: Vite
- **Testing**: Vitest
- **Icons**: FontAwesome
- **Notifications**: React-Toastify
## 🧪 Testing
```bash
# Run tests
bun run test
# Run tests with coverage
bun run test:coverage
# Run tests with UI
bun run test:ui
```
## 📦 Building for Production
```bash
# Build the project
bun run build
# Preview production build
bun run preview
```
## 🤝 Contributing
Contributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.
1. Fork the repository
2. Create your feature branch (`git checkout -b feature/AmazingFeature`)
3. Commit your changes (`git commit -m 'Add some AmazingFeature'`)
4. Push to the branch (`git push origin feature/AmazingFeature`)
5. Open a Pull Request
## 📜 License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
## 🙏 Acknowledgments
- Inspired by classic trading games
- Built with ❤️ in Australia
- Special thanks to all contributors
## 📱 Connect
- GitHub: [@loftwah](https://github.com/loftwah)
- Twitter: [@loftwah](https://x.com/loftwah)
- More Links: [linkarooie.com/loftwah](https://linkarooie.com/loftwah)
---
Made with ❤️❤️❤️ in Australia