DinoDB Documentation

Quick Start

Get up and running with DinoDB in just a few minutes.

Step 1: Add Your First AWS Account

Using AWS Credentials File

If you have ~/.aws/credentials configured: 1. Launch DinoDB 2. Your AWS profiles will appear automatically

AWS Profiles Discovered

  1. Double-click a profile to connect

Manual Account Setup

  1. Click "Add Account"

Add Account Button

  1. Fill in the form:
  2. Name: "My AWS Account"
  3. Access Key ID: Your AWS access key
  4. Secret Access Key: Your AWS secret key
  5. Region: Your preferred region (e.g., us-east-1)
  6. Tags: Optional labels (e.g., "production", "development")

Add Account Form

  1. Click **"Save"

Step 2: Connect to Your Account

  1. Double-click your account card

Double Click Connect

  1. Wait for the connection to establish

Connection Status

  1. You'll see your DynamoDB tables in the sidebar

Tables List Connected

Step 3: Browse Your Tables

Table List View

  • Tables appear in the left sidebar
  • Click any table to view its data
  • Use the search box to filter tables
  • Star tables to mark as favorites

Table List Sidebar

Table Data View

  • Table View: Spreadsheet-like interface
  • JSON View: Raw DynamoDB JSON format
  • Pagination: Navigate through large datasets
  • Sorting: Click column headers to sort

Table View Mode

Step 4: Perform Basic Operations

View Items

  1. Select a table from the sidebar
  2. Browse items in the main view
  3. Click any item to see details

Add New Item

  1. Click "Add Item" button

Add Item Button

  1. Use the JSON editor or form fields

Add Item Form

  1. Click "Save" to create the item

Edit Existing Item

  1. Double-click an item in the table

Double Click Edit Item

  1. Modify values in the detail view

Edit Item Popup

  1. Click **"Save Changes"

Delete Item

  1. Select an item
  2. Press Delete key or right-click > Delete

Right Click Delete

  1. Confirm the deletion

Delete Confirmation Dialog

Step 5: Explore Advanced Features

Query Builder

  1. Click "Query" in the toolbar

Query Button Toolbar

  1. Select your partition key
  2. Add conditions for sort keys

Query Builder Interface

  1. Click **"Run Query"

Monitoring Dashboard

  1. Select a table
  2. Click the "Metrics" tab

Metrics Tab Click

  1. View real-time CloudWatch metrics

Metrics Dashboard

  1. Set up alerts for important thresholds

Settings & Preferences

  1. Click the gear icon in the toolbar

Settings Icon Toolbar

  1. Customize:
  2. Theme (Light/Dark/System)
  3. Default page sizes
  4. Auto-refresh intervals
  5. Keyboard shortcuts

Settings Window

Common Tasks

Switching Between Accounts

  • Click different account cards to switch contexts
  • Each account maintains its own connection state
  • Visual indicators show active connections

Managing Multiple Regions

  • Add separate accounts for different regions
  • Or edit account settings to change regions
  • Tables will refresh automatically

Keyboard Shortcuts

  • ⌘N: Add new item
  • ⌘R: Refresh tables
  • ⌘F: Focus search
  • Delete: Delete selected item
  • ⌘,: Open settings

Tips for Success

Performance

  • Use pagination for large tables
  • Set appropriate page sizes in settings
  • Use queries instead of scans when possible

Security

  • Never share AWS credentials
  • Use IAM roles with minimal required permissions
  • Regularly rotate access keys

Monitoring

  • Set up CloudWatch alerts for important metrics
  • Monitor capacity utilization regularly
  • Watch for throttling events

Next Steps

Now that you're familiar with the basics: