https://github.com/blockful/trustful-stellar
https://github.com/blockful/trustful-stellar
Last synced: 4 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/blockful/trustful-stellar
- Owner: blockful
- License: mit
- Created: 2024-12-30T01:31:21.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-08-14T22:28:22.000Z (11 months ago)
- Last Synced: 2025-08-14T23:23:46.063Z (11 months ago)
- Language: TypeScript
- Homepage: https://demo-stellar.trust.ful.xyz
- Size: 1.68 MB
- Stars: 0
- Watchers: 0
- Forks: 3
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 🌟 Trustful Stellar
**Transform Your Stellar Achievements Into Verifiable On-Chain Reputation**
[](https://choosealicense.com/licenses/mit/)
[](https://nodejs.org/)
[](https://nextjs.org/)
[](https://typescriptlang.org/)
[](https://tailwindcss.com/)
[](https://stellar.org/)
[🚀 Live Demo](#) • [📖 Documentation](#) • [🐛 Report Bug](https://github.com/blockful-io/trustful-stellar/issues) • [✨ Request Feature](https://github.com/blockful-io/trustful-stellar/issues)
---
## 🎯 What is Trustful Stellar?
**Trustful Stellar** is a cutting-edge decentralized application (dApp) that revolutionizes on-chain reputation for the **Stellar ecosystem**. We transform your blockchain achievements—like **Stellar Quest badges** and ecosystem contributions—into verifiable, transparent, and actionable reputation scores.
### 💡 The Problem We Solve
In decentralized communities, proving your contributions and expertise is challenging. Traditional reputation systems are centralized and opaque. Trustful Stellar bridges this gap by creating a **trustless, verifiable reputation system** that communities can use for:
- 🗳️ **Governance voting** with weighted reputation
- 💰 **Grant allocation** based on proven track record
- 👥 **Role assignments** with verified credentials
- 🤝 **Community participation** with transparent standing
---
## ✨ Key Features
### 🔗 **Wallet Integration**
- **Stellar Wallet** (Albedo) for achievement retrieval
### 🛡️ **Verifiable Reputation**
- On-chain attestation and verification
### 🏘️ **Community-Driven**
- Multiple community contexts supported
### 🎨 **Modern UI/UX**
- Intuitive navigation and feedback
---
### 🛠️ **Core Technologies**
| Category | Technologies |
| -------------------- | ---------------------------------------------- |
| **Frontend** | Next.js 14, React 18, TypeScript, Tailwind CSS |
| **State Management** | Zustand, React Query, React Hook Form |
| **Blockchain** | Stellar SDK, Albedo |
| **UI/UX** | Lucide React, React Hot Toast, React Tooltip |
| **Development** | Storybook, ESLint, Prettier, PostCSS |
---
## 🚀 Quick Start
### 📋 Prerequisites
- **Node.js** 18.x or higher
- **npm** or **yarn**
- **Git**
### ⚡ Installation
```bash
# Clone the repository
git clone https://github.com/blockful-io/trustful-stellar.git
# Navigate to project directory
cd trustful-stellar
# Install dependencies
npm install
# Copy environment file
cp .env.example .env
```
### 🔧 Environment Setup
Create your `.env` file with the following variables:
```env
NEXT_PUBLIC_ENV=
NEXT_PUBLIC_API_URL=
NEXT_PUBLIC_RPC_URL=
NEXT_PUBLIC_NETWORK=
NEXT_PUBLIC_FACTORY_CONTRACT_ID=
```
### 🎬 Running the Application
```bash
# Start development server
npm run dev
# Open your browser
# Navigate to http://localhost:3000
```
### 📚 Component Development
```bash
# Start Storybook for UI development
npm run storybook
# Open component library
# Navigate to http://localhost:6006
```
---
## 📖 Usage Guide
### 1️⃣ **Connect Your Wallets**
- Link your Stellar wallet (Albedo) to access your achievements
### 2️⃣ **Verify Your Reputation**
- Trustful Stellar registers user reputation
### 3️⃣ **Join Communities**
- Browse available reputation contexts
- See how your score applies in different communities
---
## 🗂️ Project Structure
```
trustful-stellar/
├── 📁 src/ # Source code
│ ├── 📁 components/ # Reusable UI components
│ ├── 📁 hooks/ # Custom React hooks
│ ├── 📁 lib/ # Utility libraries
│ └── 📁 types/ # TypeScript definitions
├── 📁 app/ # Next.js App Router
├── 📁 public/ # Static assets
├── 📁 .storybook/ # Storybook configuration
├── 📄 tailwind.config.ts # Tailwind configuration
└── 📄 next.config.mjs # Next.js configuration
```
---
## 🔄 Available Scripts
| Command | Description |
| ------------------------- | --------------------------------- |
| `npm run dev` | 🏃♂️ Start development server |
| `npm run build` | 🏗️ Build production application |
| `npm run start` | 🚀 Start production server |
| `npm run lint` | 🧹 Run ESLint for code quality |
| `npm run storybook` | 📚 Start Storybook development |
| `npm run build-storybook` | 📦 Build Storybook for deployment |
---
## 🤝 Contributing
We love contributions! Here's how you can help make Trustful Stellar even better:
### 🔥 Quick Contribution Steps
1. **Fork** the repository
2. **Create** a feature branch (`git checkout -b feature/amazing-feature`)
3. **Commit** your changes (`git commit -m 'Add amazing feature'`)
4. **Push** to the branch (`git push origin feature/amazing-feature`)
5. **Open** a Pull Request
### 📋 Development Guidelines
- ✅ Use TypeScript for type safety
- ✅ Follow existing code patterns and structure
- ✅ Add comments and documentation
- ✅ Write tests when applicable
- ✅ Use semantic HTML and ARIA attributes
- ✅ Leverage Tailwind CSS classes from `globals.css`
### 🐛 Bug Reports & Feature Requests
Found a bug or have an idea? [Open an issue](https://github.com/blockful-io/trustful-stellar/issues) and let's discuss it!
---
## 🏢 About Blockful
**Built with ❤️ by [Blockful](https://blockful.io)**
We're passionate about building the future of decentralized technologies and creating tools that empower communities.
[🌐 Website](https://blockful.io) • [🐦 X](https://x.com/blockful_io) • [💼 LinkedIn](https://linkedin.com/company/blockful)
---
## 📜 License
This project is licensed under the **MIT License** - see the [LICENSE](LICENSE) file for details.
---
### 🌟 Star this repository if you found it helpful!
**Made with 💜 for the Stellar Ecosystem**
[⬆️ Back to Top](#-trustful-stellar)