gogo-movement-starter/README.md

GOGO Movement Network React Starter Template - Complete React + Vite + Move contracts setup

# GOGO Movement Network Starter Template

🚀 **Complete React + Vite + Move contracts setup for Movement Network**

A full-stack starter template that combines React frontend with Move smart contracts, ready for building dapps on Movement Network.

## ✨ Features

- **React + Vite + TypeScript** - Modern frontend setup
- **GOGO Components** - Pre-built React components for Movement Network
- **Wallet Integration** - Built-in @razorlabs/razorkit wallet adapters
- **Move Contracts** - Complete Move development environment
- **Movement Network** - Pre-configured for Movement Network endpoints
- **Interactive Setup** - Automatic installation and configuration

## 🚀 Quick Start

### Option 1: Global Installation (Recommended)

Install globally and create new projects:

```bash
npm install -g gogo-movement-starter
create-gogo-app my-movement-app
cd my-movement-app
npm run dev
```

### Option 2: Direct Installation

Install in current directory:

```bash
npm install gogo-movement-starter
npm run create
```

This will automatically:
1. ✅ Copy all React template files
2. ✅ Install dependencies
3. ✅ Set up Movement Network integration
4. ✅ Create Move contracts folder
5. ✅ Configure everything for development

### Start development:

```bash
npm run dev
```

### Work with Move contracts:

```bash
cd contracts
aptos move compile
aptos move test
aptos move publish
```

## 📁 What's Included

```
gogo-movement-starter/
├── src/                    # React components and hooks
│   ├── components/         # GOGO React components
│   ├── hooks/             # Custom hooks
│   └── movement/          # Movement Network integration
├── public/                # Static assets
├── contracts/             # Move smart contracts
│   ├── sources/           # Move source files
│   ├── tests/             # Contract tests
│   ├── Move.toml          # Project configuration
│   └── config.yaml        # Movement Network settings
├── scripts/               # Setup and installation scripts
└── package.json           # Dependencies and scripts
```

## 🎯 Movement Network Configuration

The template comes pre-configured with Movement Network endpoints:

- **RPC URL**: `https://full.testnet.movementinfra.xyz/v1`
- **Faucet URL**: `https://faucet.testnet.movementinfra.xyz/`
- **Network**: Movement Network Testnet

## 🔧 Available Scripts

- `npm run dev` - Start development server
- `npm run build` - Build for production
- `npm run setup-movement` - Reconfigure Move contracts
- `npm run lint` - Run ESLint

## 📚 Documentation

- [Movement Network Docs](https://docs.movementnetwork.xyz/)
- [GOGO Components](https://movementlabs.xyz)
- [Aptos Move](https://aptos.dev/move/)

## 🤝 Contributing

This template is built by Movement Industries. Contributions are welcome!

## 📄 License

MIT License - see LICENSE file for details.

---

**Built on Moveindustries** 🎯