Skip to content

Cojodi/alphland

Repository files navigation

Alphland logo

The home for all dapps in the Alephium ecosystem

Vercel CI

🧭 Explore the Alephium ecosystem

Visit alph.land to explore the most influential dapps in the Alephium ecosystem.

To use them, download the Alephium Desktop Wallet or use the Alephium Wallet Browser Extension for Chrome or Firefox:

✅ Add your dapp to Alphland

If you are building a dapp on Alephium and want to showcase it in Alphland, you just need to submit a PR to this repository.

Steps:

  1. Create your images: 320x320 logo, 1920x400 banner and 700x400 preview. Use the Alphland Figma template to help you.
  2. Please optimise your images using tinypng.com – JPGs are best for photos and PNGs for graphics. Or you can convert to WebP.
  3. Fork this repo and create a new folder with your dapp name under /public/dapps/
  4. Add your optimised images to the folder
  5. Copy dapp_data_example.json, rename it with your dapp's name in lowercase and move it to /data
  6. Fill out the fields in the json file with your dapp's data
  7. Ensure the json points to your images, i.e.
  "media": {
    "logoUrl": "/dapps/yourdapp/yourdapp-logo.png",
    "bannerUrl": "/dapps/yourdapp/yourdapp-banner.png",
    "previewUrl": "/dapps/yourdapp/yourdapp-preview.png",
    … etc
  }
  1. Rename env.example to env.local, npm run build and check if your dApp is displayed correctly.
  2. Create the PR if above steps succeeded.

And that's it! 🚀

Someone from the Alphland team will review the PR and contact you if they need to clarify anything.

Maintainers

This repo is maintained by Fugashu and msMatix.

For any questions either create an issue on this repo or find us on the Alephium Discord:

📣 Share your dapp rating with the world

Embed the Alphland rating widget in your application!

Widget Example

Using the widget

<a href="https://www.alph.land/{your_dapp_name}" style="display:inline-block;position:relative">
  <div style="position:absolute;top:0;right:0;bottom:0;left:0;"></div>
  <iframe src="https://www.alph.land/widgets/rating?dappname={your_dapp_name}" width="260" height="176" frameBorder="0" title="Alphland Widget"></iframe>
</a>
  1. Copy and paste the snippet above
  2. In <a href="…"> change your_dapp_name to exactly the same as the name of your dapp as shown in your Alphland url.
  3. Also change your_dapp_name in the <iframe src="…">
  4. (Optional) you can also set the theme to theme=light or theme=dark 😎 (default uses the device settings).
    Just add the theme param to the url after your dappname.
  5. That's it!

Widget example

walph on Alphland would be https://www.alph.land/walph

View example on CodeSandbox

<a href="https://www.alph.land/walph" style="display:inline-block;position:relative">
  <div style="position:absolute;top:0;right:0;bottom:0;left:0;"></div>
  <iframe src="https://www.alph.land/widgets/rating?dappname=walph" width="260" height="170" frameBorder="0" title="Alphland Widget"></iframe>
</a>

Donations

Fuel our code with caffeine! If you'd like to sponsor a coffee for our project, you can donate to our ALPH wallet address below. Every sip powers our progress! 🚀☕

16uJvxtaSkuKEz3DEzCKHsemE4LWvnqZS1WrSAhoeL9Fr

Acknowledgments

Special thanks to Argentlabs. We're deeply grateful for their work, which laid the groundwork for this project.

We are immensely grateful to Alephium and the Blockflow Alliance DAO for their generous support and sponsorship of this project.

For more information about our sponsors: