primer · algorand

Four Algorand primitives, demystified.

Every idea in this repo leans on one of four Algorand primitives. Each one runs against Algorand TestNet (a free, real network) so you can ship a verifiable demo with zero hosting and zero fees paid by your users — the sponsor account fee-pools the group.

The four secrets

Add these in your Lovable project (Settings → Secrets) before pasting any mega-prompt:

  • ALGORAND_DEPLOYER_MNEMONIC25-word mnemonic that deploys the PuyaPy contract or creates the ASA. Fund on TestNet.open ↗
  • SPONSOR_MNEMONIC25-word mnemonic that fee-pools the user's atomic group.open ↗
  • ALGOD_SERVERAlgorand node HTTPS endpoint. Nodely free tier — no token required.open ↗
  • PINATA_JWTPin to IPFS.open ↗
  • ALGOD_TOKENOptional. Use "-" for the free Nodely tier.
onchain logic

Algorand smart contract

749 ideas use this
kernel
a PuyaPy smart contract compiled and deployed to Algorand TestNet with AlgoKit — the AVM instruction set is Python-friendly, deploys settle in ~3 s, and every call is inspectable on AlgoExplorer
how it drives the UI
a 'live on Algorand TestNet' badge with the App ID and an AlgoExplorer link
wallet UX

Wallet Connect (use-wallet) + fee pooling

0 ideas use this
kernel
TxnLab @txnlab/use-wallet-react + @txnlab/use-wallet-ui for a wallet-agnostic connect flow (Pera, Defly, Exodus, Lute, WalletConnect), with a sponsor account fee-pooling the whole atomic group so users never fund an account or pay the 0.001 ALGO minimum fee
how it drives the UI
a one-tap <WalletButton /> that returns a live Algorand address from any supported wallet — no funding step
onchain authorship

ASA mint (Algorand Standard Asset)

0 ideas use this
kernel
an ASA created with acfg — total 1, decimals 0, url pointing at an IPFS CID — giving the creator a native, transferrable NFT with no contract to write
how it drives the UI
a 'mint to claim authorship' button that returns the Asset ID and an AlgoExplorer link