Bad Kids Shop

Welcome to the Badkids Shop repository! This project is an open-source initiative designed to create a seamless, Shopify-like experience for NFT transactions in the Cosmos ecosystem. It is tailored for both newcomers and veterans, simplifying the process of exploring and purchasing NFTs from any Stargaze NFT collection.

Check out our sample website for the BadKids collection here: https://badkids.shop/

Key features include:

1. NFT Listings: Displaying NFTs with images, IDs, and current prices. This includes a redirection to the NFT page on Stargaze’s marketplace, and offers flexible sorting options.

2. Wallet Connectivity: Integrating multiple methods for secure transactions:
   1. Connect and sign a transaction using MetaMask (utilizes Leap’s MetaMask Snaps).
   2. Log in with email and sign transactions (utilizes Leap’s Social login SDK).
   3. Connect with Leap or Keplr.

3. Get STARS Feature: Simplifies the process of acquiring the required STARS tokens using assets from other Cosmos chains, EVM chains, or fiat, without having to navigate between different interfaces. This feature is powered by Leap’s Elements SDK.

4. Follow on 'X' Button: Redirects users to your collection’s social media pages.

Our repository is structured to enable easy customization and deployment for your NFT projects.

Table of Contents

• Getting Started
  • Prerequisites
  • Installation
• Environment Variables
  • Setting up Environment Variables
  • Accessing Environment Variables
• Usage
• Contributing
• License

Getting Started

Prerequisites

List any software or tools that need to be installed before running the project.

• Node.js (version x.x.x)
• npm or Yarn (choose one)

Installation

1. Clone the repository:

   git clone https://github.com/leapwallet/bad-kids-shop.git

2. Navigate to the project directory:

   cd bad-kids-shop

3. Install dependencies:

   npm install
   # or
   yarn

Environment Variables

Optional environament variables

NEXT_PUBLIC_NODE_REST_ENDPOINT= // get from https://chains.cosmos.directory/stargaze
NEXT_PUBLIC_NODE_RPC_ENDPOINT= // get from https://chains.cosmos.directory/stargaze
NEXT_PUBLIC_STARGAZE_GRAPHQL_ENDPOINT= // https://graphql.mainnet.stargaze-apis.com/graphql

NEXT_PUBLIC_STARGAZE_MARKET_CONTRACT= //stars1fvhcnyddukcqfnt7nlwv3thm5we22lyxyxylr9h77cvgkcn43xfsvgv0pl
NEXT_PUBLIC_BAD_KIDS_COLLECTION_ID= //stars19jq6mj84cnt9p7sagjxqf8hxtczwc8wlpuwe4sh62w45aheseues57n420

Mandatory environment variables for Social login support, connect with capsule

NEXT_PUBLIC_CAPSULE_KEY= 
NEXT_PUBLIC_CAPSULE_ENV=

Mandatory environment variable for wallet connect

NEXT_PUBLIC_WC_PROJECT_ID= 

Setting up Environment Variables

1. Create a .env.local file in the root of your project.

   // .env.local
   
   NEXT_PUBLIC_NODE_REST_ENDPOINT=
   NEXT_PUBLIC_NODE_RPC_ENDPOINT=
   NEXT_PUBLIC_STARGAZE_GRAPHQL_ENDPOINT=
   NEXT_PUBLIC_STARGAZE_MARKET_CONTRACT=
   NEXT_PUBLIC_BAD_KIDS_COLLECTION_ID=
   
   
   NEXT_PUBLIC_WC_PROJECT_ID=
   NEXT_PUBLIC_CAPSULE_KEY= 
   NEXT_PUBLIC_CAPSULE_ENV=
   

## Usage

Explain how to run the project locally and any additional steps needed.

```bash
npm run dev
# or
yarn dev

This will start the development server, and you can view the app at http://localhost:3000 in your browser.

Contributing

Explain how others can contribute to your project. Include information about pull requests, issue reporting, coding standards, etc.

1. Fork the repository.
2. Create a new branch for your feature: git checkout -b feature-name
3. Commit your changes: git commit -m 'Add some feature'
4. Push to the branch: git push origin feature-name
5. Open a pull request.

License

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