✨ 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

---

🌟 Why AURA?

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-44)
• ⚡ Lightning Integrated — Send and receive Bitcoin payments via NWC
• 🌍 Open Source — Transparent, auditable, and community-driven
• 📱 PWA Ready — Install on any device, works offline

"They can't stop the signal."

---

✨ Features

🏠 Social Feed

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

💬 Private Messaging

• End-to-end encrypted DMs (NIP-04 & NIP-44)
• Conversation list with unread indicators
• Real-time message delivery
• Offline message queue

👤 Profiles

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

💰 Lightning Wallet

• Nostr Wallet Connect (NWC) integration
• Send and receive Bitcoin payments
• Transaction history
• ⚡ Zap support for posts and users

🔍 Search

• Search notes by content
• Find users by name or npub
• Discover hashtags
• Trending topics

⚙️ Settings

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

---

🛠️ Tech Stack

Category	Technology
Framework	SvelteKit 2 + Svelte 5
Language	TypeScript (strict mode)
Styling	Tailwind CSS 4
Nostr	NDK (Nostr Dev Kit)
Database	Dexie.js (IndexedDB wrapper)
Crypto	@noble libraries
Testing	Vitest + Playwright
Icons	Lucide
Validation	Zod

---

🚀 Quick Start

Prerequisites

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

Installation

# 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.

Build for Production

# Create production build
bun run build

# Preview production build
bun run preview

---

📖 Documentation

Project Structure

AURA/
├── src/
│   ├── lib/
│   │   ├── components/     # Reusable UI components
│   │   │   ├── feed/       # Feed-related components
│   │   │   ├── notifications/
│   │   │   └── ui/         # Base UI components
│   │   ├── core/           # Core utilities (errors, resilience)
│   │   ├── db/             # Dexie.js database
│   │   ├── i18n/           # Internationalization
│   │   ├── services/       # Business logic services
│   │   │   ├── crypto/     # Encryption (NIP-44)
│   │   │   ├── ndk/        # NDK service modules
│   │   │   └── wallet/     # NWC client
│   │   ├── stores/         # Svelte 5 runes stores
│   │   ├── utils/          # Utility functions
│   │   └── validators/     # Zod schemas & sanitization
│   ├── routes/             # SvelteKit routes
│   └── app.css             # Global styles
├── static/                 # Static assets
├── tests/                  # Test files
│   ├── e2e/                # Playwright E2E tests
│   └── unit/               # Vitest unit tests
└── ...config files

Nostr NIPs Implemented

NIP	Description	Status
NIP-01	Basic protocol	✅
NIP-02	Contact List	✅
NIP-04	Encrypted DMs (legacy)	✅
NIP-05	DNS Verification	✅
NIP-07	Browser Extension	✅
NIP-10	Replies & Threading	✅
NIP-18	Reposts	✅
NIP-25	Reactions	✅
NIP-44	Versioned Encryption	✅
NIP-47	Nostr Wallet Connect	✅

Available Scripts

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

---

🌐 Deployment

Vercel (Recommended)

AURA is optimized for deployment on Vercel:

GitHub Pages

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

IPFS (Censorship Resistant)

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>

---

🤝 Contributing

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.

---

🔒 Security

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.

---

📜 License

This project is licensed under the MIT License — see the LICENSE file for details.

This means you can:

• ✅ Use it commercially
• ✅ Modify it freely
• ✅ Distribute it
• ✅ Use it privately

---

⚖️ Legal Disclaimer

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.

---

💜 Support the Project

If AURA has helped you, consider supporting its development:

⚡ Bitcoin (Lightning Network)

classywallaby932694@getalby.com

🟣 Solana

DANryD6MxNr3BQcYZN3rao9qM4VzS2sx7sHy944emPH2

🔷 Ethereum / EVM

0xC2335f06ab8Ef2512375bB8Cd2c07A7Bd1589A6e

🌟 Other Ways to Help

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

---

👨‍💻 Author

Artem Pryanishnikov

Creator & Lead Developer

---

🙏 Acknowledgments

• 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

---

"Information wants to be free"

Built with 💜 for a free and open internet

If you believe in freedom of speech and decentralization,
please consider starring ⭐ this repository and sharing AURA with others.

Together, we can build a better, freer world.