Socket
Book a DemoInstallSign in
Socket

create-dynamic-app

Package Overview
Dependencies
Maintainers
1
Versions
20
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

create-dynamic-app

CLI tool to generate sample applications using Dynamic's web3 authentication

latest
Source
npmnpm
Version
2.3.2
Version published
Weekly downloads
28
3.7%
Maintainers
1
Weekly downloads
 
Created
Source

Create Dynamic App

Dynamic Logo

A powerful CLI tool to generate starter applications with Dynamic's web3 authentication. Quickly bootstrap projects using your preferred frameworks, libraries, and blockchain networks.

Table of Contents

Installation

You can use Create Dynamic App directly with npx:

npx create-dynamic-app my-project-name

Or install it globally:

npm install -g create-dynamic-app
create-dynamic-app my-project-name

Quick Start

# Create a new project with interactive prompts
npx create-dynamic-app my-web3-app

# Create a project with a specific package manager
npx create-dynamic-app my-web3-app --pm yarn

# Create a Next.js project with Ethereum and Solana support
npx create-dynamic-app my-web3-app --framework nextjs --chains ethereum,solana

# Create a React project with complete configuration
npx create-dynamic-app my-web3-app --framework react --chains ethereum,solana --library viem --wagmi true --pm pnpm

Command-Line Options

Create Dynamic App supports the following command-line options:

OptionAliasDescriptionValues
--help-hShow help information
--framework-fSpecify the frameworknextjs, react, react-native
--pm, --package-managerSpecify the package managernpm, yarn, pnpm, bun
--library-lSpecify the Ethereum libraryviem, ethers
--wagmiUse Wagmi with Viemtrue, false
--chains-cComma-separated list of chainsethereum, solana, flow, starknet, algorand, cosmos, bitcoin, sui

If you don't specify options via command line, you'll be prompted to choose interactively.

Features

  • Multiple Framework Support: Generate applications using Next.js, React, or React Native
  • Blockchain Flexibility: Choose from 7 different blockchain networks to include
  • Library Options: Select your preferred Ethereum libraries (Viem or Ethers.js)
  • Wagmi Integration: Optional Wagmi support for enhanced React hooks
  • Package Manager Choice: Select your preferred package manager (npm, yarn, pnpm, or bun)
  • Command-Line Configuration: Specify all options via command-line flags for automation
  • Ready-to-use Components: Includes auth components and chain-specific utility methods
  • Dark/Light Mode: Built-in theme support that respects system preferences

Supported Chains

The CLI supports the following blockchain networks:

ChainPackageFeatures
Ethereum@dynamic-labs/ethereumFull wallet connection, signing, transactions
Solana@dynamic-labs/solanaWallet connection, signing, program interactions
Flow@dynamic-labs/flowWallet integration and authentication
Starknet@dynamic-labs/starknetLayer 2 integration and account management
Algorand@dynamic-labs/algorandWallet connection and transaction signing
Cosmos@dynamic-labs/cosmosMulti-chain Cosmos ecosystem support
Bitcoin@dynamic-labs/bitcoinBasic Bitcoin wallet connectivity
Sui@dynamic-labs/suiWallet connection and utility methods

Project Options

Frameworks

  • Next.js: Server-side rendering, file-based routing, optimized for production
  • React: Client-side SPA with Vite configuration
  • React Native: Mobile application support with Expo

Library Options

When including Ethereum support, you can choose:

  • Viem: Modern, lightweight TypeScript library for Ethereum
  • Ethers.js: Popular, full-featured Ethereum library
  • Wagmi: React hooks for Ethereum (can be combined with Viem)

Package Manager Options

You can choose your preferred package manager for installing dependencies:

  • npm
  • yarn
  • pnpm
  • bun

Usage Examples

Generate a Next.js App with Specific Options

# Interactive creation
npx create-dynamic-app my-next-app

# Create with specific options
npx create-dynamic-app my-next-app --framework nextjs --chains ethereum,solana --library viem --wagmi true --pm yarn

Generate a React App

# Interactive creation
npx create-dynamic-app my-react-app

# Create with specific options
npx create-dynamic-app my-react-app --framework react --chains ethereum,solana,algorand --library ethers --pm pnpm

Generate Projects for Development/Testing

# Generate all variations for testing
npm run generate:all

# Create with specific chains for testing
npx create-dynamic-app test-app --chains ethereum,solana,starknet

Project Structure

The generated projects follow best practices for their respective frameworks:

Next.js Project

my-next-app/
├── app/                 # Next.js app directory
│   ├── page.tsx         # Main application page
│   └── layout.tsx       # Root layout
├── components/          # React components
├── lib/                 # Utility functions
│   ├── dynamic.ts       # Dynamic SDK exports
│   ├── providers.tsx    # Context providers
│   └── wagmi.ts         # Wagmi configuration (if selected)
├── public/              # Static assets
└── package.json         # Dependencies and scripts

React Project

my-react-app/
├── public/              # Static assets
├── src/                 # Source code
│   ├── App.js           # Main application component
│   ├── Main.js          # Content component
│   ├── Methods.js       # Chain-specific utility methods
│   └── index.js         # Application entry point
└── package.json         # Dependencies and scripts

Troubleshooting

Common Issues

Issue: Error installing dependencies with npm Solution: Try using --legacy-peer-deps flag or specify a different package manager:

# Using the CLI
npx create-dynamic-app my-app --pm yarn

# Or manually
cd my-dynamic-project
npm install --legacy-peer-deps

Issue: Conflicts with Solana dependencies Solution: The generator adds necessary overrides. If you have issues, manually set:

"overrides": {
  "rpc-websockets": "7.10.0",
  "@solana/web3.js": "1.91.6"
}

Issue: Environment ID is missing Solution: Replace the placeholder in providers.tsx/App.js:

environmentId: "YOUR_ENVIRONMENT_ID", // Get from Dynamic dashboard

License

ISC License - see the LICENSE file for details.

Keywords

dynamic

FAQs

Package last updated on 16 Aug 2025

Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

About

Packages

Stay in touch

Get open source security insights delivered straight into your inbox.

  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc

U.S. Patent No. 12,346,443 & 12,314,394. Other pending.