Skip to content

About

Requests And Offers is a hAppenings.community project to facilitate exchange between Holochain creators, developers, advocates, projects and organisations! It's an agent-centric, distributed marketplace of requests and offers built with Holochain.

Topics

Resources

Stars

17 stars

Watchers

3 watching

Forks

Latest commit

Β 

History

1,170 Commits

Folders and files

NameName
Last commit message
Last commit date
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Requests and Offers

Ask DeepWiki

A simple peer-to-peer bulletin board for the Holochain community, enabling creators, developers, and organizations to post requests and offers for services, skills, and resources with direct contact facilitation.

Warning

This project is in alpha and is not production ready. Expect breaking changes, incomplete features, and potential instability. Use at your own risk.

Requests and Offers home page

πŸš€ Quick Start

# Clone and setup
git clone https://github.com/Happening-Community/requests-and-offers.git
cd requests-and-offers && nix develop
bun install && bun start

πŸ“– Documentation

Essential Reading

Quick Reference

πŸ› οΈ Development Commands

Running the Application

# (from project root) 
# Development Mode - Full Holochain app with dev features
bun start              # Start complete Holochain app (2 agents by default)
AGENTS=3 bun start     # Custom number of agents
bun start:web          # Browser tabs, one URL per member; both open the conductor inspector

Testing

bun test               # All tests
bun test:ui            # Frontend tests
bun test:unit          # Unit tests (no Nix needed)
bun test:integration   # Integration tests

Building

bun build:zomes        # Build zomes
bun build:happ         # Build complete hApp
bun package            # Package for distribution

Note: Unit tests do not need Nix; building zomes, the hApp and Sweettest does. Use nix develop --command bun build:happ for those.

πŸ”§ Development Features System

The project uses atomic environment-based feature control through the DevFeatures Service, providing fine-grained control over development features without a master switch.

🎯 Atomic Feature Control

Each development feature is independently controlled via environment variables:

# Mock/Testing Utilities - Shows mock data buttons in forms for testing
VITE_MOCK_BUTTONS_ENABLED=false

# Network Peers Display - Shows all network peers in test mode
VITE_PEERS_DISPLAY_ENABLED=false

πŸ§‘β€πŸ’» Development Mode

  • Purpose: Full development experience with debugging tools
  • Command: bun start (from project root)
  • Features: Mock data buttons, network peers display, development utilities
  • Environment: Uses .env with atomic feature control
  • Service: DevFeatures Service provides centralized feature management

πŸ—οΈ Build Mode

The application supports production builds through Vite:

  • Production Build: bun run build (from ui directory)

Development features are controlled at runtime via the atomic environment variables in .env, not through different build configurations.

πŸ—οΈ Architecture Integration

The DevFeatures Service follows the 7-layer Effect-TS architecture:

  • Service Layer: DevFeaturesService with Context.Tag dependency injection
  • Schema Validation: Type-safe Effect Schema definitions
  • Component Integration: Used across all form components
  • Production Safety: Automatic removal via Vite tree-shaking

Usage Example:

import { shouldShowMockButtons } from '$lib/services/devFeatures.service';

// In components without Effect context
if (shouldShowMockButtons()) {
  // Show mock data buttons
}

For detailed information, see Architecture Overview and Developer Guide.

πŸ“ Project Structure

requests-and-offers/
β”œβ”€β”€ dnas/requests_and_offers/    # Holochain DNA with coordinator/integrity zomes
β”œβ”€β”€ ui/                          # SvelteKit frontend with 7-layer Effect-TS architecture
β”œβ”€β”€ tests/sweettest/             # Sweettest integration tests (Rust)
└── documentation/               # Comprehensive project documentation

See Architecture Overview for detailed system design.

πŸ—ΊοΈ Where the Project Stands

The bulletin board MVP is done, and the 0.6.0 alphas build the exchange process on top of it. CHANGELOG.md records each change as it lands.

Shipped

  • Bulletin Board: Requests and offers, each with one approved service type
  • Members and Organizations: Profiles, organizations, and an administration that reviews applications with reasons
  • Search & Browse: Find requests and offers by title or description, and browse them by service type
  • Exchange Process: Interest, proposals and counter-proposals, agreements, and completion by each party, mirrored into hREA as Valueflows commitments and events

In Progress

  • In-App Messaging: Encrypted conversations between members, and proposals started from a listing

Later

  • Reputation System: Reviews and ratings after an exchange
  • Advanced Matching: Algorithmic request and offer matching

The original scope is in MVP Documentation, and the designs for the later features are in post-MVP requirements.

🀝 Community & Licensing

About

Requests And Offers is a hAppenings.community project to facilitate exchange between Holochain creators, developers, advocates, projects and organisations! It's an agent-centric, distributed marketplace of requests and offers built with Holochain.

Topics

Resources

Stars

17 stars

Watchers

3 watching

Forks

Releases

Packages

Used by

Contributors

Languages