Skip to content

louisdevzz/growx

Repository files navigation

GrowX

GrowX is an open funding and growth infrastructure platform built on the Ancient8 Chain. It is designed to support builders, game studios, and Web3 projects in raising capital, expanding communities, and achieving sustainable development through a transparent, on-chain, and community-centric approach.

Overview

Inspired by public funding models like Potlock, GrowX provides a suite of tools for creating fundraising campaigns, distributing grants, and incentivizing contributions through smart contracts. By recording all cash flows, decisions, and impacts on-chain, GrowX eliminates the need for blind trust and significantly improves accountability.

Why GrowX?

Unlike traditional crowdfunding platforms, GrowX is native to the Ancient8 ecosystem, placing games, Web3 social, and creator communities at its core.

GrowX is more than just a place to ask for funding—it is a comprehensive growth engine. It empowers projects to:

  • Connect with early users.
  • Build and nurture communities.
  • Experiment with incentive mechanisms.
  • Optimize growth strategies from the earliest stages.

Vision

GrowX strives to create an ecosystem where great ideas are nurtured by the community. We believe that true growth should not rely on short-term advertising but on consensus, contribution, and trust—all encoded and verified by blockchain technology.

Technical Architecture

GrowX is built using a modern Web3 technology stack, ensuring performance, scalability, and developer experience.

Core Stack

  • Frontend Framework: Next.js 15 (App Router)
  • Language: TypeScript
  • Styling: Tailwind CSS with Shadcn UI components
  • State Management: React Query (@tanstack/react-query)
  • Web3 Integration:
  • Database: MongoDB (Mongoose) for off-chain data persistence

Smart Contracts (Ancient8 Testnet)

Contract Name Address
Manager 0xbC488574bebfdAED71fEcF968541469682b8A9AC
Funding 0xCfFbBc13df5cDF7Cd21D92e84bdfBB9b29C07172
Round 0x9c9dED808f6Bc48Aa38a7a46F9F140BD15c898a5
Project 0xd31499246573E80FcbF9633190E4D181482033AC
Investor 0x267AF09bd5CFF4ef6713245Ce5FBe0d60af87eBc

Getting Started

Follow these instructions to set up the project locally.

Prerequisites

  • Node.js: >= 18.17.0
  • Package Manager: pnpm (recommended), npm, or yarn

Installation

  1. Clone the repository:

    git clone <repository-url>
    cd growx
  2. Install dependencies:

    pnpm install
  3. Environment Setup: Create a .env.local file in the root directory and add the necessary environment variables:

    # Database
    MONGODB_URI=your_mongodb_connection_string
    
    # WalletConnect
    NEXT_PUBLIC_WALLETCONNECT_PROJECT_ID=your_project_id
    
    # Twitter Integration
    NEXT_PUBLIC_TWITTER_CLIENT_ID=your_twitter_client_id
    NEXT_PUBLIC_TWITTER_CLIENT_SECRET=your_twitter_client_secret

Running the Application

Start the development server:

pnpm dev

Open http://localhost:3000 with your browser to see the result.

Build for Production

To create a production build:

pnpm build

To start the production server:

pnpm start

Project Structure

├── public/          # Static assets
├── src/
│   ├── app/         # Next.js App Router pages and API routes
│   ├── components/  # React components (Shadcn UI, etc.)
│   ├── lib/         # Utility functions and configurations (MongoDB, Wagmi)
│   └── ...
├── next.config.ts   # Next.js configuration
├── tailwind.config.ts # Tailwind CSS configuration
└── ...

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

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

About

GrowX is an open funding and growth infrastructure platform built on the Ancient8 Chain.

Resources

License

Stars

Watchers

Forks

Contributors