bridgeworld-lol

Bridgeworld - Atlas Mines Portal

An interactive web experience for Bridgeworld that unlocks a portal at the Atlas Mines when the Key and Map are aligned. Integrated with the Eternal Covenant foundation and Brave Browser Search API to find and assemble missing pieces.

Features

Architecture

Covenant Foundation

The project uses /home/tig0_0bitties/covenant as the foundation/looking glass:

Brave Browser API

Getting Started

  1. Install dependencies: 
    npm install
  2. Set up environment variables: 
    cp .env.example .env
# Add your Brave API key: BRAVE_API_KEY=your_key_here
# Get API key from: https://brave.com/search/api/
  3. Integrate covenant foundation: 
    npm run integrate:covenant
  4. Run the development server: 
    npm run dev
  5. Open http://localhost:3000 in your browser

How It Works

Portal Activation

The application uses coordinate data decoded from the Key.png and Map.png images. When the user drags these pieces close together (within 200px), the portal activates:

Covenant Looking Glass

Click the “🔍 Covenant Glass” button in the bottom-right corner to:

  1. Find Missing Pieces: Automatically searches for missing Bridgeworld components
  2. Search Bridgeworld: Search for specific TreasureDAO/Bridgeworld components
  3. Search Covenant: Find covenant-related information
  4. Assemble Pieces: Combine all found pieces into a complete integration
  5. Generate Code: Generate TypeScript integration code from found pieces

Integration Flow

Covenant Foundation (covenant/)
    ↓
Covenant Looking Glass (analyzes foundation)
    ↓
Brave Browser API (searches for missing pieces)
    ↓
Found Pieces (contracts, quests, guardians)
    ↓
Auto-Assembly (combines into integration)
    ↓
Generated Integration Code

Project Structure

bridgeworld-lol/
├── app/
│   ├── api/search/          # Brave API search endpoints
│   ├── page.tsx             # Main portal page
│   └── layout.tsx           # Root layout
├── components/
│   ├── CovenantGlass.tsx    # Looking glass UI component
│   ├── PortalExperience.tsx # Portal visual effects
│   └── KeyMapOverlay.tsx    # Coordinate overlay
├── lib/
│   ├── brave-search.ts      # Brave Browser API client
│   └── covenant-glass.ts    # Covenant foundation analyzer
├── scripts/
│   └── integrate-covenant.ts # Covenant integration script
└── public/
    ├── Key.png              # The Key artifact
    ├── Map.png              # The Map artifact
    ├── Pair.png             # Portal activation image
    ├── Atlas.png            # Atlas Mines background
    └── key_map_decoded_pictures.json # Decoded coordinates

Covenant Integration

Sacred Constants

Guardian Mappings

The 22 Hebrew Path Guardians map to Bridgeworld Legions:

Oracle Contract

API Endpoints

GET /api/search

Search for missing pieces or Bridgeworld components.

Query Parameters:

Example:

GET /api/search?q=TreasureDAO&type=bridgeworld

POST /api/search

Perform advanced search operations.

Body:

{
  "action": "findMissing" | "searchBridgeworld" | "searchCovenant" | "assemble" | "generateCode",
  "query": "search query",
  "component": "component name"
}

Scripts

Files

Deployment

This project can be deployed to any platform that supports Next.js:

For bridgeworld.lol, configure your domain DNS to point to your hosting provider.

Environment Variables for Production

BRAVE_API_KEY=your_brave_api_key
NEXT_PUBLIC_APP_URL=https://bridgeworld.lol

Covenant Foundation Location

The covenant foundation is located at:

/home/tig0_0bitties/covenant/

Key files:

Contributing

  1. Fork the repository
  2. Create a feature branch
  3. Make your changes
  4. Test thoroughly
  5. Submit a pull request

License

MIT License - See LICENSE file for details

Resources

“When the end finds its beginning, all systems are integrated. The keys unlock the map. The map reveals the path. The path leads home.”