Neura - AI-Powered DeFi Platform

• AI-Powered Trading - Machine learning-driven trading strategies
• Vault Management - Automated yield optimization and risk management
• Portfolio Analytics - Real-time tracking and performance metrics
• Secure Authentication - Web3 wallet integration with Privy
• Responsive Design - Optimized for all devices

• Frontend: React 18, TypeScript, Vite
• Styling: Tailwind CSS, Shadcn/ui
• Web3: Wagmi, Viem, Privy
• State Management: React Query, Context API
• Testing: Jest, React Testing Library

Before you begin, ensure you have the following installed:

• Node.js (v18 or higher)
• Package Manager (pnpm recommended)

  npm install -g pnpm

• Git (for version control)
• Web3 Wallet (MetaMask, Coinbase Wallet, etc.)

1. Clone the repository

   git clone https://github.com/operari-xyz/Neura-frontend.git
   cd Neura-frontend

2. Install dependencies

   # Using pnpm (recommended)
   pnpm install
   
   # Alternative: using npm
   npm install
   
   # Alternative: using yarn
   yarn install

3. Environment Configuration

   • Copy the example environment file:

     cp .env.example .env

   • Update the .env file with your configuration:

     # Required Environment Variables
     VITE_PRIVY_APP_ID=your_privy_app_id
     VITE_QUICKNODE_RPC_URL=your_quicknode_rpc_url
     
     # Optional Configuration
     VITE_ENVIRONMENT=development
     VITE_APP_VERSION=1.0.0

4. Start Development Server

   # Start development server
   pnpm run dev

   The application will be available at http://localhost:8080

5. Building for Production

   # Build for production
   pnpm run build
   
   # Preview production build
   pnpm run preview

src/
├── components/     # Reusable UI components
│   ├── ui/        # Shadcn/ui components
│   └── shared/    # Custom shared components
├── hooks/         # Custom React hooks
├── lib/           # Utility functions and configurations
├── pages/         # Page components
├── styles/        # Global styles and theme
└── types/         # TypeScript type definitions

• Frontend Framework: React 18 with TypeScript
• Build Tool: Vite
• Styling: Tailwind CSS with CSS Modules
• State Management:
  • React Query for server state
  • Context API for global state
  • Local state with React hooks
• Web3:
  • Wagmi for Ethereum interactions
  • Viem for type-safe Web3
  • Privy for authentication
• UI Components:
  • Shadcn/ui for accessible components
  • Radix UI primitives
  • Framer Motion for animations

• MetaMask
• Coinbase Wallet
• Rabby
• WalletConnect

• Connection is wallet-driven using Wagmi connectors. The app gates content by wallet connection (isConnected).
• Use the Connect Wallet button in the Navbar to initiate a Wagmi connect() flow. External wallets (e.g., MetaMask, Rabby, Coinbase) are supported; embedded wallets and email/SSO are not.
• Disconnect using the Disconnect button in the Navbar, which calls Wagmi's useDisconnect.

1. Build the application

   pnpm run build

   This will create an optimized production build in the dist directory.

1. Push your code to a GitHub repository
2. Import the repository in Vercel
3. Configure environment variables
4. Deploy!

1. Set up a web server (Nginx/Apache)
2. Configure SSL (Let's Encrypt recommended)
3. Serve the dist directory
4. Set up proper caching headers

1. Fork the repository
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

This project is licensed under the MIT License - see the LICENSE file for details.

• Built with ❤️ by the Operari team
• Special thanks to our beta testers and community

pnpm run build

This creates optimized production files in the dist directory.

• Static Hosting: Deploy the dist directory to any static hosting service
• Docker: A Dockerfile is provided for containerized deployment
• CI/CD: Configure with GitHub Actions or similar for automated deployment

pnpm run test

The test suite includes unit tests and integration tests to ensure application reliability.

Contributions are welcome! Please follow these steps:

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

Please ensure your code follows the project's coding standards and includes appropriate tests.

This project is licensed under the MIT License - see the LICENSE file for details.