Skip to content

Home

Jump to bottom
Emil Krebs edited this page Jul 11, 2025 · 4 revisions

VailNote Wiki (Outated)

Welcome to the VailNote wiki! This is your comprehensive guide to understanding and using VailNote - a simple, open-source note-sharing app designed for maximum privacy.

🔗 Quick Links

📖 About VailNote

VailNote is a privacy-focused note-sharing application that prioritizes security and user anonymity. All notes are encrypted using modern encryption technology before being stored, ensuring that no one else can access them without proper authorization.

Key Features

  • 🔒 End-to-end encryption (JavaScript mode)
  • 🗂️ Self-destructing notes - automatically deleted after viewing
  • 🔑 Optional password protection
  • ⏰ Configurable expiration times (10 minutes to 30 days)
  • 🚫 No tracking or analytics
  • 📱 No-JavaScript fallback for maximum compatibility
  • 🛡️ Privacy-preserving rate limiting using Anonymous Rate-Limited Credentials (ARC)

🏗️ Architecture Overview

VailNote supports two operational modes:

JavaScript Mode (Recommended)

  • Client-side encryption before transmission
  • Enhanced security through local key generation
  • Password hashing with SHA-256
  • Zero-knowledge server architecture

Non-JavaScript Mode

  • Server-side encryption for compatibility
  • SSL/TLS protection during transmission
  • Fallback option for clients without JavaScript support

🛠️ Tech Stack

  • Framework: Fresh (Deno)
  • Runtime: Deno
  • Database: MongoDB
  • Encryption: AES-GCM with SHA-256 key derivation
  • Frontend: Tailwind CSS & Preact

🚀 Getting Started

For Users

  1. Visit vailnote.com
  2. Create your note with optional password protection
  3. Set expiration time (10 minutes to 30 days)
  4. Share the generated link securely
  5. Note is automatically destroyed after viewing

For Developers

  1. Clone the repository
  2. Set up MongoDB instance
  3. Configure environment variables
  4. Run deno task start
  5. Access at http://localhost:8000

🔐 Security Model

VailNote implements multiple layers of security:

  • Client-side encryption (JavaScript mode)
  • Password hashing with SHA-256 and bcrypt
  • Self-destructing notes after single view
  • No persistent storage of decrypted content
  • Anonymous rate limiting with ARC protocol

📚 Documentation Sections

🤝 Contributing

VailNote is open-source and welcomes contributions. Check out the GitHub repository to:

  • Report issues
  • Submit feature requests
  • Contribute code improvements
  • Enhance documentation

📝 License

This project is licensed under the MIT License - promoting open-source collaboration while maintaining flexibility for users and contributors.

Last updated: July 7, 2025

Clone this wiki locally