HashStack Base Client

A modern, Web3-enabled Next.js application built with TypeScript and TailwindCSS. This project serves as the base client for HashStack's decentralized platform.

🏗 Architecture

Tech Stack

• Framework: Next.js 15.1 with React 19
• Language: TypeScript
• Styling: TailwindCSS with SASS support
• Web3: RainbowKit, wagmi, and viem for blockchain interactions
• State Management: Zustand
• Data Fetching: TanStack Query (React Query)
• UI Components: Radix UI primitives

Project Structure

├── app/                  # Next.js 15 app directory (pages, layouts)
├── assets/              # Static assets (images, icons)
├── components/          # Reusable UI components
│   ├── ui/             # Base UI components
│   └── ...             # Feature-specific components
├── constant/           # Application constants and configurations
├── context/            # React context providers
├── features/           # Feature-specific modules
├── hooks/              # Custom React hooks
├── lib/                # Third-party library configurations
├── store/              # Zustand store definitions
├── styles/             # Global styles and Tailwind configurations
├── types/              # TypeScript type definitions
├── utils/              # Utility functions
└── web3/               # Web3-specific implementations

🚀 Getting Started

Prerequisites

• Node.js 18+
• Yarn package manager

Installation

# Install dependencies
yarn install

# Setup environment variables
cp .env.example .env.local

# Start development server
yarn dev

The application will be available at http://localhost:3000.

Development Features

• TurboRepo Integration: Faster development builds
• TypeScript: Strict type checking
• ESLint & Prettier: Code quality and formatting
• Tailwind CSS: Utility-first CSS framework with animations

🔧 Configuration

Environment Variables

Copy .env.example to .env.local and configure:

• NEXT_PUBLIC_WALLET_CONNECT_ID: WalletConnect Project ID
• NEXT_PUBLIC_ALCHEMY_ID: Alchemy API Key
• Additional network-specific variables

Web3 Configuration

Web3 providers and network configurations are managed in web3/ directory. The application supports multiple networks through RainbowKit and wagmi.

📦 Build & Deployment

# Production build
yarn build

# Start production server
yarn start

🤝 Contributing

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

This project is proprietary software. All rights reserved.