✨ AURA

Decentralized Social Messenger for the Free World

AURA is a censorship-resistant social messenger built on the Nostr protocol.
It empowers people to communicate freely, without fear of surveillance or censorship.

Because freedom of speech is a human right, not a privilege.

🚀 Live Demo · 📖 Documentation · 🐛 Report Bug · 💡 Request Feature

In a world where social platforms control what you see, who you can reach, and what you can say — AURA offers an alternative. Built on the Nostr protocol, AURA is:

• 🔓 Truly Decentralized — No single company controls your data or can ban you
• 🛡️ Censorship Resistant — Your voice cannot be silenced by any authority
• 🔐 Privacy First — End-to-end encrypted direct messages (NIP-17 Gift Wraps)
• ⚡ Lightning Integrated — Send and receive Bitcoin payments via NWC
• 💰 eCash Support — Anonymous payments with Cashu tokens
• 🛒 Decentralized Marketplace — Buy and sell with Bitcoin (NIP-15)
• 🤖 AI Chat — Decentralized AI via Data Vending Machines (NIP-90)
• 🌍 Open Source — Transparent, auditable, and community-driven
• 📱 Mobile Ready — PWA + Capacitor for native Android/iOS builds

"They can't stop the signal."

• Global and personalized feeds
• Real-time updates via WebSocket subscriptions
• Infinite scroll with optimistic UI updates
• Create posts, reply, repost, and react

• End-to-end encrypted DMs with NIP-17 Gift Wraps (metadata hidden)
• Legacy NIP-04 support for backwards compatibility
• Conversation list with unread indicators
• Real-time message delivery with offline queue
• Send eCash (Cashu tokens) in messages

• View and edit your Nostr profile
• Follow/unfollow users
• Contact list management (NIP-02)
• Verified user badges (NIP-05)

• Nostr Wallet Connect (NWC) integration
• Cashu eCash for anonymous payments
• Send and receive Bitcoin via Lightning
• Swap between Lightning ⇄ eCash
• Transaction history
• ⚡ Zap support for posts and users (NIP-57)

• Browse decentralized product listings
• Filter by category, price, condition
• Web of Trust integration for seller reputation
• Direct messaging with sellers
• Pay with Lightning or eCash

• Decentralized AI via Data Vending Machines
• Pay-per-use with Lightning sats
• Text generation, translation, summarization
• No accounts, no tracking

• Search notes by content
• Find users by name or npub
• Discover hashtags with #tag filters
• Advanced filters (date range, author, content type)
• Search history and saved searches
• Trending topics

• Public channels for communities
• Real-time group messaging
• Create and join groups
• Member management
• Reply threading

• One-on-one video calls via Jitsi
• Voice calls support
• Call invite via DM
• In-call controls (mute, video toggle, screen share)
• Call history

• Create image/text stories
• Stories bar with avatars
• Full-screen story viewer
• Auto-delete after 24 hours
• View tracking

• Create polls with 2-4 options
• Vote on polls
• Real-time results
• Optional end time

• Save posts for later
• Private bookmark list
• Quick access from sidebar

• Hold-to-record in DMs
• Waveform visualization
• Play/pause controls
• Upload via Blossom

• Web Push API support
• Notification settings (mentions, DMs, zaps)
• Service Worker integration

• Generate profile QR code
• Share nostr:npub URI
• Downloadable image

• Relay management
• Theme customization (light/dark)
• Language selection (EN, ES, RU, ZH)
• Data export and cache management

AURA features a Liquid Glass visual system — an advanced glassmorphism aesthetic inspired by modern UI trends. Sticky headers, sidebars, and navigation bars use tinted blur with specular highlights and spring-like transitions, creating a frosted-glass feel that adapts to both light and dark modes. Combined with a cyberpunk oklch color palette, neon glow effects, and animated gradient borders, the interface delivers a distinctive, immersive experience.

• Node.js >= 18.0.0
• Bun (recommended) or npm/yarn/pnpm

# Clone the repository
git clone https://github.com/FrankFMY/AURA.git
cd AURA

# Install dependencies
bun install

# Start development server
bun run dev

Open http://localhost:5173 in your browser.

# Create production build
bun run build

# Preview production build
bun run preview

AURA/
├── src/
│   ├── lib/
│   │   ├── components/     # Reusable UI components
│   │   │   ├── bookmarks/  # Bookmark button
│   │   │   ├── calls/      # Video/audio calls UI
│   │   │   ├── cashu/      # eCash components
│   │   │   ├── feed/       # Feed-related components
│   │   │   ├── groups/     # Group chat components
│   │   │   ├── media/      # Media upload (Blossom)
│   │   │   ├── messages/   # Voice messages
│   │   │   ├── notifications/
│   │   │   ├── polls/      # Poll creation & voting
│   │   │   ├── profile/    # Profile QR code
│   │   │   ├── stories/    # Stories bar & viewer
│   │   │   ├── verified/   # NIP-05 verification
│   │   │   ├── wot/        # Web of Trust components
│   │   │   └── ui/         # Base UI components
│   │   ├── core/           # Core utilities (errors, resilience)
│   │   ├── db/             # Dexie.js database
│   │   ├── i18n/           # Internationalization
│   │   ├── services/       # Business logic services
│   │   │   ├── blossom/    # Decentralized file storage
│   │   │   ├── calls/      # Jitsi video calls
│   │   │   ├── crypto/     # Encryption (NIP-44, Gift Wrap)
│   │   │   ├── dvm/        # Data Vending Machines (AI)
│   │   │   ├── ndk/        # NDK service modules
│   │   │   ├── nip05/      # NIP-05 verification
│   │   │   └── wallet/     # NWC + Cashu eCash
│   │   ├── stores/         # Svelte 5 runes stores
│   │   ├── utils/          # Utility functions
│   │   └── validators/     # Zod schemas & sanitization
│   ├── routes/             # SvelteKit routes
│   │   ├── ai/             # AI Chat page
│   │   ├── bookmarks/      # Saved posts
│   │   ├── call/           # Video/audio call page
│   │   ├── groups/         # Group chats
│   │   ├── marketplace/    # NIP-15 Marketplace
│   │   └── ...
│   └── app.css             # Global styles
├── static/                 # Static assets
├── tests/                  # Test files (646+ tests)
│   ├── e2e/                # Playwright E2E tests
│   └── unit/               # Vitest unit tests
├── android/                # Capacitor Android (generated)
└── ...config files

bun run dev          # Start development server
bun run build        # Build for production
bun run preview      # Preview production build
bun run check        # Type-check with svelte-check
bun run test         # Run unit tests
bun run test:e2e     # Run E2E tests
bun run test:coverage # Run tests with coverage

AURA is optimized for deployment on Vercel:

AURA can also be deployed to GitHub Pages using the included workflow.

For maximum censorship resistance, deploy AURA to IPFS:

# Using Pinata (set PINATA_API_KEY and PINATA_API_SECRET first)
bun run deploy:ipfs --provider pinata

# Using local IPFS node
bun run deploy:ipfs --provider local

Once deployed, access AURA via any IPFS gateway:

• https://ipfs.io/ipfs/<CID>
• https://dweb.link/ipfs/<CID>
• https://cloudflare-ipfs.com/ipfs/<CID>

AURA uses Capacitor for native mobile builds:

# Build web assets
bun run build

# Add Android platform (first time only)
bunx cap add android

# Sync web assets to native
bunx cap sync android

# Open in Android Studio
bunx cap open android

Build APK in Android Studio:

1. Open Android Studio
2. Build > Build Bundle(s) / APK(s) > Build APK(s)
3. APK location: android/app/build/outputs/apk/

Requirements:

• Android Studio with Android SDK
• For release builds: signing key

Contributions are what make the open source community amazing! Any contributions you make are greatly appreciated.

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

See CONTRIBUTING.md for detailed guidelines.

AURA takes security seriously. If you discover a security vulnerability, please report it responsibly:

• Email: Pryanishnikovartem@gmail.com
• Subject: [SECURITY] AURA Vulnerability Report

Please do not create public issues for security vulnerabilities.

See SECURITY.md for our security policy.

This project is licensed under the GNU Affero General Public License v3.0 — see the LICENSE file for details.

AURA is built on the belief that freedom, once given, should never be taken away. The AGPL v3 ensures that every fork, every deployment, every version of this code remains open and free — not just for developers, but for every user who connects to it.

If you build on AURA, you share the same freedom forward. That's not a restriction — that's a promise.

• ✅ Use, modify, and distribute freely
• ✅ Deploy on your own servers
• ✅ Build commercial services on top
• 🔗 Keep derivative works open-source under the same license
• 🔗 Provide source access to users interacting over a network

AURA is a client-side interface for the Nostr protocol. We do not host, store, or control any user content. All cryptographic keys are stored locally on the user's device. Content displayed in AURA is fetched from decentralized relays operated by independent third parties.

The developers of AURA:

• Do not have access to user private keys or messages
• Cannot modify or delete content published by users
• Are not responsible for content published on the Nostr network
• Cannot comply with takedown requests as we do not host content

For concerns about specific content, please contact the relay operators directly.

If AURA has helped you, consider supporting its development:

classywallaby932694@getalby.com

DANryD6MxNr3BQcYZN3rao9qM4VzS2sx7sHy944emPH2

0xC2335f06ab8Ef2512375bB8Cd2c07A7Bd1589A6e

• ⭐ Star this repository
• 🐛 Report bugs and suggest features
• 📝 Improve documentation
• 🌍 Help with translations
• 📢 Spread the word about Nostr and AURA

• Nostr Protocol — For creating a truly decentralized protocol
• NDK — For the excellent Nostr development kit
• Svelte — For the amazing framework
• All Contributors — Who help make this project better