Basic Usage

CodeNut is an AI-powered Web3 development platform that helps you build full-stack decentralized applications. This guide will walk you through the basics of using CodeNut to create your first DApp.

Creating Your First Project

CodeNut supports multiple authentication methods:

OAuth Login: Sign in with Google or GitHub for quick access
Web3 Wallets: Connect with MetaMask and other wallets powered by REOWN (formerly WalletConnect) using Sign-In with Ethereum (SIWE)

2. Starting a New Project

You can start building your DApp in two ways:

From the Home Page: Simply type your project requirements directly in the input field on the home page
From a Project: Click the "New Project" button in the sidebar if you're already in a project

The AI will automatically:

Generate an appropriate project name and description
Set up the optimal project structure for your needs
Configure all necessary dependencies

3. AI Chat Interface

The heart of CodeNut is the AI chat interface where you interact with specialized agents:

Type your requests: Describe what you want to build in natural language
Real-time responses: See AI responses stream in real-time
Context awareness: The AI remembers your project context and previous conversations
Tool execution: Watch as the AI uses tools to edit files, run commands, and more

Working with AI Agents

CodeNut uses specialized AI agents for different tasks:

🤖 General Agent

Code generation and editing
Project setup and configuration
General development assistance

🔐 Security Agent

Code security analysis
Smart contract vulnerability detection
Best practices enforcement

💎 Crypto Expert

Blockchain-specific development
Smart contract creation
Web3 integration guidance

🎨 UI Developer

Frontend design and styling
Component creation
User interface optimization

🐛 Debug Agent

Error diagnosis and fixing
Performance optimization
Testing assistance

Project Structure

CodeNut projects follow standard Web3 development patterns:

your-project/
├── src/                 # Frontend source code
│   ├── components/     # React components
│   ├── pages/         # Page components
│   ├── contracts/     # Smart contract interfaces
│   └── utils/         # Utility functions
├── contracts/          # Smart contract source
├── public/            # Static assets
└── package.json       # Dependencies