Secure, on-the-go access control and guild management.
Key Features • Getting Started • Architecture • Testing • Roadmap • Contributing
Part of the Adamantine-Guild project — a Web3 membership and token-gated community platform built for the open-source ecosystem.
GuildPass Mobile is the official gateway to the GuildPass ecosystem for iOS and Android. It empowers users to manage their digital memberships, verify on-chain roles, and unlock token-gated experiences directly from their mobile devices. Built with performance and security at its core, it leverages modern Web3 standards to provide a seamless user experience.
- 🛡️ Universal Membership: View all your active guild memberships and assigned roles in a unified dashboard.
- 🔍 Instant Verification: Execute real-time protocol checks for token-gated resources with zero friction.
- 🌐 Cross-Chain Support: Explore guild configurations and role requirements across supported EVM networks.
- ⚡ High Performance: Native-speed interactions powered by React Native and efficient server-state management.
- 🎨 Fluid Design: A beautiful, accessible UI built with NativeWind, optimized for both light and dark environments.
- Node.js: 18.0 or higher
- Package Manager: pnpm (recommended) or npm
- Mobile Environment: Expo Go installed on your device, or configured iOS/Android simulators.
# Clone the repository
git clone https://github.com/Adamantine-Guild/guildpass-mobile.git
cd guildpass-mobile
# Install dependencies
pnpm install
# Set up environment variables
cp .env.example .env
# Edit .env with your API URL and chain ID# Start the development server
pnpm start
# Launch on specific platforms
pnpm ios
pnpm androidThe application is built on a robust, feature-driven foundation designed for long-term maintainability:
- Routing: Expo Router for type-safe, file-based navigation.
- State: Zustand for client state and TanStack Query for server synchronization.
- Styling: NativeWind for high-performance Tailwind CSS utility styling.
- SDK: Seamless integration with the core @guildpass/sdk.
| Path | Purpose |
|---|---|
app/ |
Expo Router file-based pages and layouts |
src/ |
Feature modules, hooks, stores, and services |
docs/ |
Architecture and integration guides |
tests/ |
Vitest unit tests |
# Run all tests (watch mode)
pnpm test
# Run tests once (CI mode)
pnpm test:run
# Type checking
pnpm typecheck
# Lint
pnpm lint
# Format
pnpm format- Native Wallet Integration: Support for WalletConnect, MetaMask, and Coinbase Wallet.
- Smart Onboarding: Social login and embedded wallets for non-crypto native users.
- Push Notifications: Real-time alerts for role updates and access grants.
- QR Gating: Generate dynamic QR codes for physical event access.
- Offline Resilience: Advanced caching layer for viewing memberships without connectivity.
We welcome contributions from the community! See CONTRIBUTING.md for the full guide.
- Browse open issues tagged
good first issueorhelp wanted. - Comment on the GitHub issue you'd like to work on.
- Fork the repo, create a feature branch, implement your change, open a PR.
- Contact: cerealboxx123@gmail.com
Distributed under the MIT License. See LICENSE for more information.
Crafted with precision by the GuildPass team
guildpass.xyz