Getting Started

Nostr.App - Getting Started Guide

Welcome to Nostr.App, a collection of decentralized applications built on the Nostr protocol. This guide will help you get started with using the platform, whether you're new to Nostr or already have an existing Nostr identity.

Table of Contents

1. What is Nostr?
2. For New Users: Creating Your First Nostr Identity
3. For Existing Users: Importing Your Nostr Keys
4. Using the Applications
5. Security Best Practices

What is Nostr?

Nostr (Notes and Other Stuff Transmitted by Relays) is a simple, open protocol that enables global, decentralized, and censorship-resistant social media. Unlike traditional social platforms, Nostr gives you complete control over your identity and data through cryptographic key pairs.

• Public Key: Your identity on the network (like a username)
• Private Key: Your password and control mechanism (keep this secret!)

For New Users: Creating Your First Nostr Identity

If you're new to Nostr and don't have a key pair yet, follow these steps:

1. Navigate to the Key Generator:

   • From the main app directory, click on the "Key Generator" card
   • Or directly visit the keygen.html page

2. Generate a New Key Pair:

   • On the Key Generator page, select the "Generate New Keys" tab
   • Click the "Generate New Key Pair" button
   • The system will create a unique key pair for you (it will generate a vanity address starting with "aa1")
   • You'll see a status indicator showing the generation progress

3. Save Your Keys:

   • Once generated, you'll see your public key (npub) and private key (nsec and hex format)
   • IMPORTANT: Your private key is the ONLY way to access your Nostr account
   • You have three options to save your keys:
     • Click "Save Keys to Browser" to store them in your browser's local storage
     • Click "Download as Text File" to save them as a text file on your device
     • Manually copy and store them in a secure password manager

4. Security Warning:

   • Never share your private key with anyone
   • Store it securely - if you lose it, you lose access to your account permanently
   • Consider using multiple backup methods for your private key

For Existing Users: Importing Your Nostr Keys

If you already have a Nostr identity (private key), you can import it to use with this application:

1. Navigate to the Key Generator:

   • From the main app directory, click on the "Key Generator" card
   • Or directly visit the keygen.html page

2. Import Your Existing Key:

   • Select the "Import Existing Keys" tab
   • Enter your private key in either:
     • nsec format (starts with "nsec1...")
     • hex format (64 characters)
   • Click the "Import Key" button

3. Use Your Imported Keys:

   • The system will derive your public key from your private key
   • You can save these keys to the browser by clicking "Save Keys to Browser"
   • You're now ready to use the applications with your existing Nostr identity

4. Using a Nostr Extension:

   • If you use a browser extension like nos2x or Alby, the application can detect and use your extension
   • Simply click "Login with Nostr" in the header, and it will connect to your extension

Using the Applications

Once you have your Nostr identity set up, you can use any of the applications in the directory:

Core Applications:

1. Todo App:

   • Track your tasks and stay organized
   • Your tasks are stored on Nostr relays and tied to your identity
   • Create, edit, and mark tasks as complete
   • Your tasks sync across devices when using the same Nostr identity

2. Bookmarks:

   • Save and organize your favorite links
   • Add titles, descriptions, and tags to your bookmarks
   • Search and filter your bookmarks collection
   • Access your bookmarks from any device using your Nostr identity

3. Pastebin:

   • Share code and text snippets
   • Create permanent, shareable links to your content
   • Support for syntax highlighting for various programming languages
   • Set expiration times for temporary content

Utility Applications:

1. Profile:

   • Manage your Nostr user profile
   • Update your display name, about information, and profile picture
   • These changes will be visible across the Nostr network
   • View your profile as others see it on the Nostr network

2. Key Generator:

   • Create or import Nostr keys as described above
   • Generate vanity addresses with custom prefixes
   • Securely store and manage your Nostr identity

3. Hello World:

   • A simple starter application to demonstrate Nostr functionality
   • Learn the basics of Nostr interaction

4. Mindstr:

   • A mind mapping application for organizing thoughts and ideas
   • Create and share mind maps with other Nostr users

Security Best Practices

1. Private Key Security:

   • Never share your private key with anyone
   • Use a password manager or secure storage solution
   • Consider creating a backup stored in a safe location

2. Browser Storage:

   • While convenient, browser storage is not the most secure option
   • If you clear your browser data, you may lose access to your keys
   • Consider using a dedicated Nostr extension for better security

3. Multiple Devices:

   • To use your identity on multiple devices, you'll need to import your private key on each device
   • Consider using a Nostr extension that can sync across devices

4. Public Information:

   • Remember that content posted to Nostr is public and permanent
   • Be mindful of the personal information you share

What Makes Nostr Special

Nostr offers several advantages over traditional web applications:

1. Decentralization: Your data isn't controlled by a single company or server
2. Censorship Resistance: No central authority can remove your content
3. Portability: Use your identity across any Nostr-compatible application
4. Privacy: You control your data and how it's shared
5. Permanence: Your content remains available as long as relays exist

---

With your Nostr identity set up, you're ready to explore the decentralized web! The applications in this directory are just the beginning of what's possible with Nostr.