@alphland/dapps

A comprehensive list of dApps on the Alephium blockchain, curated and maintained by Alphland.

Installation

npm install @alphland/dapps

or

yarn add @alphland/dapps

Usage

Using the bundled dApp list

import { dapps, DappDirectory } from '@alphland/dapps';

// Get all dApps
console.log(dapps);

// Filter by tag
const defiDapps = dapps.filter(dapp => dapp.tags?.includes('DeFi'));

// Find a specific dApp
const ayin = dapps.find(dapp => dapp.slug === 'ayin');

// Get verified dApps
const verifiedDapps = dapps.filter(dapp => dapp.verified);

// Get featured dApps first
const sorted = [...dapps].sort((a, b) => Number(b.isFeatured) - Number(a.isFeatured));

Using the API (/api/dapps-directory)

Use the DappDirectory type when consuming the GET https://alph.land/api/dapps-directory endpoint, which returns all dApps with slug, isFeatured, and absolute media URLs.

import type { DappDirectory } from '@alphland/dapps';

const res = await fetch('https://alph.land/api/dapps-directory');
const dapps: DappDirectory[] = await res.json();

// Show featured dApps first
const sorted = [...dapps].sort((a, b) => Number(b.isFeatured) - Number(a.isFeatured));

Data Structure

Each dApp contains the following information:

• slug: Unique identifier (filename without .json)
• isFeatured: Whether the dApp is featured (Spotlight or By Alephium)
• name: Name of the dApp
• description: Full description
• short_description: One-liner description
• tags: Categories (DeFi, NFTs, Games, etc.)
• verified: Whether contracts are verified on Alephium
• audits: List of security audits
• contracts: Smart contract addresses
• tokens: Token information
• links: Social media and documentation links
• media: Logos, banners, and preview images
• teamInfo: Team and project information

Available Tags

• Onramps
• Bridges
• DeFi
• Games
• NFTs
• Social
• DAOs
• Infrastructure
• Wallets
• Security
• Hashrate
• Stats
• ComingSoon

TypeScript Support

This package includes full TypeScript type definitions.

import type { DappDirectory, DappInfo, Audit, Contract, Links, Media } from '@alphland/dapps';

Data Source

The data is sourced from the Alphland repository and is updated regularly.

Contributing

To add or update a dApp, please submit a PR to the main repository.

License

MIT