Transform Your Stellar Achievements Into Verifiable On-Chain Reputation
π Live Demo β’ π Documentation β’ π Report Bug β’ β¨ Request Feature
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.
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
|
|
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 |
- Node.js 18.x or higher
- npm or yarn
- Git
# 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
Create your .env
file with the following variables:
NEXT_PUBLIC_ENV=
NEXT_PUBLIC_API_URL=
NEXT_PUBLIC_RPC_URL=
NEXT_PUBLIC_NETWORK=
NEXT_PUBLIC_FACTORY_CONTRACT_ID=
# Start development server
npm run dev
# Open your browser
# Navigate to http://localhost:3000
# Start Storybook for UI development
npm run storybook
# Open component library
# Navigate to http://localhost:6006
- Link your Stellar wallet (Albedo) to access your achievements
- Trustful Stellar registers user reputation
- Browse available reputation contexts
- See how your score applies in different communities
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
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 |
We love contributions! Here's how you can help make Trustful Stellar even better:
- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature
) - Commit your changes (
git commit -m 'Add amazing feature'
) - Push to the branch (
git push origin feature/amazing-feature
) - Open a Pull Request
- β 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
Found a bug or have an idea? Open an issue and let's discuss it!
Built with β€οΈ by Blockful
We're passionate about building the future of decentralized technologies and creating tools that empower communities.
π Website β’ π¦ X β’ πΌ LinkedIn
This project is licensed under the MIT License - see the LICENSE file for details.
Made with π for the Stellar Ecosystem