Welcome to the POTLOCK Playground Frontend, an interactive environment designed to test and explore the features of the POTLOCK Cross Chain Donation Widget. This frontend allows developers and users to experiment with widget configurations, visualize donation flows, and simulate cross-chain transactions.

• Interactive Widget Testing: Adjust and test widget settings in real-time.
• Cross-Chain Simulation: Simulate donations across networks like NEAR, Solana, Ethereum, and more.
• Live Preview: See immediate changes to themes, colors, and configurations.
• Responsive Design: Optimized for desktop and mobile views.

• Node.js (v16.x or later)
• npm or yarn
• A code editor (e.g., VS Code)

1. Clone the repository:

   git clone https://github.com/PotLock/cross-chain-widget-playground
   cd cross-chain-widget-playground

2. Install dependencies:

   npm install

   or

   yarn install

3. Start the development server:

   npm run dev

   or

   yarn dev

• Launch Playground: Open http://localhost:5173 (or the port specified in your terminal) after starting the server.
• Configure Widget: Use the form to set Address, donationTarget, buttonColor, and Asset values.
• Test Donation Flow: Click the "Simulate Donation" button to see the QR code and confirmation process.
• Copy Code: Generate HTML or React code snippets via the "Export Code" button.

To build the playground for production:

npm run build

or

yarn build

The output will be in the dist folder.

Run unit tests with:

npm test

or

yarn test

Deploy to a static hosting service (e.g., Vercel, Netlify) by pushing the dist folder or configuring a build pipeline.

We welcome contributions! Fork the repository, create a feature branch, and submit a pull request. Follow the project's coding standards and include tests.

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

For issues or questions, open an issue on GitHub or contact support@potlock.org.

• Built with React, Vite, and Tailwind CSS.
• Thanks to the NEAR community for inspiration and support.

This README was last updated at 12:19 PM CDT on Tuesday, June 24, 2025.