PROJECT NYX

Privacy is a right, not a feature.

Project Nyx is a decentralized-style messaging application built to prove that secure communication doesn't require your phone number, email, or government ID. We use (Curve25519) cryptography to ensure that even if our database is compromised, your messages look like mathematical garbage to anyone but the intended recipient...

No trackers. No ads. No metadata mining. Just you and the person you're talking to. (only if you have a person to talk...lol)

---

🧠 How it Works (The Architecture)

Unlike traditional chat apps that store your messages in plain text (or hold the keys themselves), ProjectNyx operates as a Zero-Knowledge Relay And we are thriving for "ONION ROUTING SOON".

The Security Model

We use the Cryptographic encryption key system. Keys are generated locally on your device and never leave it.

sequenceDiagram
    participant Nanako as User Nanakochan
    participant Cloud as Cloud (Blind Relay)
    participant Shiina as User Shiinachan

    Note over Nanako, Shiina: 1. Handshake (Public Keys Exchanged)
    Nanako->>Nanako: Encrypt Message<br/>(Shiina's Public Key + Nanako's Private Key)
    Nanako->>Cloud: Send Encrypted Trash (0x8f3a...)
    Note right of Cloud: The Cloud cannot read this.<br/>It only sees random bytes.
    Cloud->>Shiina: Push Encrypted Trash
    Shiina->>Shiina: Decrypt<br/>(Nanako's Public Key + Shiina's Private Key)
    Note over Shiina: Message becomes readable

Loading

Identity Generation

Your identity is math probabaility high-end stuff (nevermind), not a row in a database. We don't store passwords or your lovely chats, which means we can't reset them. Your 12-word phrase is the seed for everything.

graph TD
    A[Start] --> B[Generate 12-Word Mnemonic]
    B --> C{Derive Keys}
    C --> D["Public Key <br/> (Your Mailbox Address)"]
    C --> E["Private Key <br/> (Your House Key)"]
    D --> F[Upload to Relay]
    E --> G[Stored LOCALLY in Browser]
    G --> H[Never Sent to Server]

Loading

---

✨ Features

• 🚫 No Phone Numbers: Sign up with a Nyx cryptographic key. Total anonymity.
• 🔒 ECE-Grade Encryption: Uses tweetnacl (Curve25519) for high-speed, High-grade security.
• 📱 Responsive Design: Works flawlessly on Desktop, Mobile, and Tablets with a responsive split-view UI (Still working on an app though).
• 🌗 Theming: Beautiful (i guess) Dark/Light modes with a clean, distraction-free interface.
• ⚡ Real-Time: Instant message delivery using Firestore snapshots (obv, they are encrypted).
• 📸 Media Sharing: Securely share images (Still working).

---

🛠️ Tech Stack

We kept the stack modern and fast. No legacy code here.

• Frontend: React + Vite
• Language: TypeScript (Strict typing for security)
• Styling: Tailwind CSS + Radix UI primitives
• State: Jotai (Atomic state management)
• Crypto: TweetNaCl.js (Port of NaCl)
• Backend: Google Firebase (Firestore) used strictly as a blind data relay.

---

🚀 Getting Started

Want to run this locally on your computer or contribute? Follow these steps.

Prerequisites

• Node.js (v16 or higher)
• npm or yarn
• A Firebase project (free tier works fine)

1. Clone the Repo

git clone https://github.com/NITHINSPACETIME/project-Nyx.git
cd project-Nyx

2. Install Dependencies

Grab all the necessary packages.

npm install

3. Configure Environment

You need to connect your own Firebase instance.

1. Create a file named src/lib/firebase.ts.
2. Paste your configuration keys (from Firebase Console -> Project Settings):

// src/lib/firebase.ts
import { initializeApp } from "firebase/app";
import { getFirestore } from "firebase/firestore";

const firebaseConfig = {
  apiKey: "YOUR_API_KEY",
  authDomain: "YOUR_PROJECT.firebaseapp.com",
  projectId: "YOUR_PROJECT_ID",
  storageBucket: "YOUR_PROJECT.firebasestorage.app",
  messagingSenderId: "...",
  appId: "..."
};

const app = initializeApp(firebaseConfig);
export const db = getFirestore(app);

4. Run Development Server

npm run dev

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

---

🤝 Contributing

We welcome contributions (Cause comeon i can't do it alone, nvm i can do it alone)! Whether it's fixing a typo, improving the UI, or auditing the crypto implementation.

1. Fork the repository.
2. Create a new branch: git checkout -b feature/amazing-feature.
3. Make your changes.
4. Commit your changes:

   git add .
   git commit -m "feat: Added voice notes support"

5. Push to the branch:

   git push origin feature/amazing-feature

6. Open a Pull Request.

Roadmap

• Voice & Video Calls (Nyx WebRTC)
• Group Chats
• Disappearing Messages (Still Working)
• Desktop Electron App and Android App (SOON!!!)

---

⚠️ Security Disclaimer

This project is currently in (pre-Alpha Stages). While we use standard cryptographic libraries (Nyx), this specific implementation has not yet undergone a third-party security audit. Use for casual privacy, Don't Start whistleblowing on governments (for now though).

---

Built by NITHINSPACETIME (ahh)