Apps Module

Build web applications with database persistence powered by AppDB.

Overview

The Apps module creates interactive web applications that store and retrieve data using NeuroGen's built-in AppDB system. Unlike static websites, apps have: - Database Persistence - Data survives page refreshes and is shared across visitors - CRUD Operations - Create, read, update, delete records - Real-Time State - No localStorage hacks, real server-side storage - Advanced Frameworks - React, Vue, FastAPI, Express, and fullstack combos

Getting Started

1. Navigate to Dashboard > Apps
2. Click Create App or choose from templates
3. Select a framework (React, Vue, Tailwind, fullstack, etc.)
4. Describe your app's functionality
5. The AI generates a working app with AppDB integration
6. Test in the live preview, then publish

Frameworks

AppDB — Built-In Database

Every app project gets an AppDB instance automatically. No setup, no schema, no migrations.

JavaScript API

// Shared data (visible to all visitors)
await AppDB.shared.list('tasks')              // List all documents
await AppDB.shared.set('tasks', id, data)     // Create or update
await AppDB.shared.get('tasks', id)           // Read one document
await AppDB.shared.remove('tasks', id)        // Delete

// Per-visitor data (private to each browser)
await AppDB.list('preferences')
await AppDB.set('preferences', 'theme', { dark: true })
await AppDB.get('preferences', 'theme')
await AppDB.remove('preferences', 'theme')

How It Works

• AppDB client is auto-injected at publish time — no <script> tag needed
• Data is stored server-side in NeuroGen's infrastructure
• Guard with: if (!window.AppDB) { /* show loading or error */ }
• Use crypto.randomUUID() for document IDs

Templates

• Task Manager - Full CRUD task app with filters and completion tracking
• Notes App - Create, edit, and organize notes with categories

Publishing

Apps are published the same way as websites: - Preview URL for testing - Public URL at neurogen.cc/p/your-slug - Custom subdomain deployment

File Storage

Exported app ZIPs are saved to My Files > Apps.

Converting Websites to Apps

Existing website projects can be converted to apps: 1. Open the project settings 2. Change the category to "App" 3. An AppDB key is auto-generated 4. The project moves to the Apps module

Tips

• Always use AppDB for user-generated data — localStorage is only for UI preferences
• Use AppDB.shared.* for data all visitors should see (tasks, posts, products)
• Use AppDB.* (without shared) for per-visitor data (preferences, cart, drafts)
• The AI automatically uses AppDB when building in the Apps module