The home for all projects in the Alephium ecosystem

🧭 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 project to Alphland

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

Windows Users: See WINDOWS_SETUP.md for setup instructions to ensure Git hooks work properly.

IMPORTANT: PLEASE

Steps:

1. Create your images: 320x320 logo, 1920x400 banner and 700x400 preview. Please name them logo.webp banner.webp and preview.webp. Use the Alphland Figma template to help you.
2. Convert your images to webp. You can use a tool like Cloudconvert.
3. Fork this repo and create a new folder with your project name under /public/dapps/
4. Add your optimised images to the folder
5. Copy dapp_data_example.json, rename it with your project's name in lowercase and move it to /data
6. Fill out the fields in the json file with your project's data
7. Ensure the json points to your images, i.e.

  "media": {
    "logoUrl": "/dapps/yourdapp/yourdapp-logo.webp",
    "bannerUrl": "/dapps/yourdapp/yourdapp-banner.webp",
    "previewUrl": "/dapps/yourdapp/yourdapp-preview.webp",
    … etc
  }

8. Copy .env.example to .env.local, npm run build and check if your project is displayed correctly.
9. 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 baby.

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

📣 Share your project rating with the world

Embed the Alphland rating widget in your application!

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 project 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>

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 :