How props-labs/props-fuels works
Project type and purpose
• This is a monorepo (managed with pnpm + TurboRepo) for the “Props SDK,” a TypeScript/JavaScript library that enables minting NFTs on the Fuel blockchain.
• It bundles four major concerns:
• A core SDK library (packages/props-fuels)
• On-chain smart contracts written in Sway (packages/sway-programs)
• A reference/demo web app built with SvelteKit (apps/demo-props-fuels)
• Documentation site built with VitePress (apps/docs)
• The README describes the SDK’s goal: simplify NFT minting, editions, and built-in incentive mechanics via a high-level PropsSDK API that sits on top of fuels’ Provider & Wallet.
File structure
• Top-level meta/config: pnpm-workspace.yaml, turbo.json, build configs (tsconfig.json, tsdoc.base.json, typedoc.json), Bit metadata.
• packages/props-fuels: the core SDK package. Contains submodules for collections, editions, contracts, core, sway-api (ABI wrappers), utils, plus tests and build config (tsup.config.ts).
• packages/sway-programs: multiple Sway-based Fuel smart contracts (Collection, Edition, FeeSplitter, Registry) each with source (.sw) and Rust-based test harnesses.
• apps/demo-props-fuels: a SvelteKit frontend demo showcasing the SDK. Includes routes, components, styles, tests, and uses Vite.
• apps/docs: VitePress site generating API reference and guides (pulls from apps/docs/api/*.md generated by TypeDoc).
• packages/scripts: Node/TS scripts for automation (e.g., create-edition.ts).
Key insights from README
• High-level usage: instantiate PropsSDK, call methods like editions.create().
• Relies on external Provider and Wallet from fuels to interact with the Fuel Testnet/Mainnet.
• Encourages a minimal code footprint for end-users.