Add push notification registration and preferences

[Lakes41]

Difficulty: Advanced

Type: Feature

Summary

Add the foundation for push notifications so users can receive updates about role changes, access grants, and membership status changes.

Current Behaviour

The README roadmap lists push notifications, but the app does not include notification permission handling, token registration, or user notification preferences.

Expected Behaviour

Users should be able to opt in to push notifications, register their device token with a backend endpoint, and manage basic notification categories from settings.

Suggested Implementation

Add Expo Notifications support, permission prompts, token registration, and settings toggles for supported categories. Use a service boundary so backend registration can be mocked until a live endpoint is available.

Files or Areas Likely Affected

• app/settings.tsx
• src/features/notifications/
• src/lib/guildpassClient.ts
• app.json
• .env.example
• README.md
• tests/

Acceptance Criteria

• Users can grant or deny notification permissions
• Device push tokens are registered through a service boundary
• Notification preferences can be viewed and changed in settings
• Permission denial is handled without breaking the app
• Mock mode can simulate token registration success and failure
• Documentation explains required Expo notification setup

Additional Notes

Assumption: backend support may not be ready yet. If so, define the client-side contract and provide a mock adapter.

[Chigybillionz]

Hi, I’ve reviewed this issue and I’m confident I can fix it. I’d like to take it on.

[gloskull]

Hello, I have 4 years of experience delivering solutions for projects like this, covering backend, frontend, and smart contract development. After carefully reviewing your requirements, I have a clear understanding of the task and am confident in my ability to deliver a clean, efficient, and thoroughly tested solution on time. I prioritize code quality, maintainability, and industry best practices throughout the development process.
My PR will be submitted in under 10hours.

[grantfox-oss]

🦊 GrantFox — @gloskull has been assigned to this issue as part of the Official Campaign campaign!

Next steps:

1. Open a Pull Request referencing this issue (e.g., Closes #21)
2. Your PR will be reviewed by the Adamantine-guild maintainers

Good luck! Track your progress on GrantFox.