Skip to content

fabianbormann/WalkInWallet

Repository files navigation

WalkInWallet | The NFT Gallery App

Release Discord conventionalcommits

WalkInWallet allows you to walk in wallets as you walk in galleries.

WalkInWallet is an open-source React project that allows you to walk through wallets as you would walk in galleries. It generates a random 3D gallery out of every NFT in your wallet. The project is based on Babylon.js for the 3D rendering. The galleries are created using the wallet address as a seed for the random function, ensuring that a gallery would only be extended by new NFTs but never changed completely. The application is built on the Cardano blockchain and uses Koios to query the chain data.

WalkInWallet preview

✨ Features

  • 3D Galleries: Explore NFTs in visually appealing 3D galleries.
  • Random Seed Based: Each gallery is generated based on a random seed, preserving the uniqueness.
  • Koios Integration: Query Cardano on-chain data seamlessly using Koios integration.
  • jpg.store Link: The link displayed below every NFT will bring you directly to jpg.store.
  • ADA Handles Support: Resolve simple and memorable names to Cardano addresses.

🎬 Demo

See the project in action by visiting our demo wallet.

🛠️ Installation

  1. Clone the repository: git clone https://github.com/fabianbormann/WalkInWallet.git
  2. Change directory: cd WalkInWallet
  3. Install dependencies: npm i
  4. Start the development server: npm start

🚀 Usage

  1. Make sure you have an ADA Handle, stake address or payment address of a Cardano wallet containing NFTs.
  2. Open the application in your browser or goto https://walkinwallet.com/<ADA_HANDLE | ADDRESS | POLICY_ID>.
  3. Enjoy walking through 3D galleries!

🤝 Contributing

We appreciate every kind of contribution! If you want to contribute to the project, please follow these steps:

  1. Fork the repository.
  2. Create a new branch: git checkout -b feature/your-feature-name
  3. Make your changes and commit them using Conventional Commits: git commit -m 'feat: add some feature'
  4. Push the changes to your fork: git push origin feature/your-feature-name
  5. Submit a pull request to the main repository.

Please ensure your code follows the project's coding style and that tests pass before submitting the pull request.

📜 License

WalkInWallet is licensed under the GPLv3 License. See the LICENSE file for more details.

🙏 Acknowledgments

  • Babylon.js - One of the most powerful, beautiful, simple, and open web rendering engines in the world.
  • Koios - A distributed & open-source public API query layer for Cardano.

📞 Support

If you have any questions or need assistance, please reach out to support@walkinwallet.com or contact us on Discord.