Installation

Prerequisites

Before installing AssetMinder, make sure you have:

Node.js 18 or later
A package manager (npm, yarn, or pnpm)
A database (PostgreSQL, MySQL, or SQLite)

Framework Installation

Create a new Next.js project

npx create-next-app@latest my-simplasset-app
cd my-simplasset-app

Install AssetMinder

npm install @simplasset/core @simplasset/ui @simplasset/cli

Initialize AssetMinder

npx simplasset init

Configure your database

Add your database configuration to .env.local:

.env.local

DATABASE_URL="postgresql://username:password@localhost:5432/mydb"
SIMPLASSET_SECRET="your-secret-key"

Create a new Nuxt.js project

npx nuxi@latest init my-simplasset-app
cd my-simplasset-app

Install AssetMinder

npm install @simplasset/nuxt @simplasset/core

Add the Nuxt module

nuxt.config.ts

export default defineNuxtConfig({
  modules: ['@simplasset/nuxt'],
  simplasset: {
    // Configuration options
  }
})

Configure environment variables

.env

DATABASE_URL="postgresql://username:password@localhost:5432/mydb"
SIMPLASSET_SECRET="your-secret-key"

Create a new SvelteKit project

npm create svelte@latest my-simplasset-app
cd my-simplasset-app
npm install

Install AssetMinder

npm install @simplasset/sveltekit @simplasset/core

Configure SvelteKit adapter

vite.config.js

import { sveltekit } from '@sveltejs/kit/vite';
import { simplasset } from '@simplasset/sveltekit';

export default {
  plugins: [sveltekit(), simplasset()]
};

Set up environment variables

.env

DATABASE_URL="postgresql://username:password@localhost:5432/mydb"
SIMPLASSET_SECRET="your-secret-key"

Create a new Astro project

npm create astro@latest my-simplasset-app
cd my-simplasset-app

Install AssetMinder

npm install @simplasset/astro @simplasset/core

Configure Astro integration

astro.config.mjs

import { defineConfig } from 'astro/config';
import simplasset from '@simplasset/astro';

export default defineConfig({
  integrations: [simplasset()]
});

Add environment variables

.env

DATABASE_URL="postgresql://username:password@localhost:5432/mydb"
SIMPLASSET_SECRET="your-secret-key"

Create a new React project

npx create-react-app my-simplasset-app
cd my-simplasset-app

Install AssetMinder

npm install @simplasset/react @simplasset/core

Set up AssetMinder provider

src/App.tsx

import { AssetMinderProvider } from '@simplasset/react';

function App() {
  return (
    <AssetMinderProvider config={{ apiUrl: '/api' }}>
      {/* Your app components */}
    </AssetMinderProvider>
  );
}

Configure environment variables

.env

REACT_APP_DATABASE_URL="postgresql://username:password@localhost:5432/mydb"
REACT_APP_SIMPLASSET_SECRET="your-secret-key"

Database Setup

AssetMinder supports PostgreSQL, MySQL, and SQLite. We recommend PostgreSQL for production applications.

PostgreSQL

# Install PostgreSQL (macOS)
brew install postgresql
brew services start postgresql

# Create a database
createdb my-simplasset-db

MySQL

# Install MySQL (macOS)
brew install mysql
brew services start mysql

# Create a database
mysql -u root -p -e "CREATE DATABASE my_simplasset_db;"

SQLite

For development, you can use SQLite which requires no additional setup:

.env

DATABASE_URL="file:./dev.db"

Verification

After installation, verify everything is working:

npx simplasset generate
npx simplasset migrate
npm run dev

Visit your application and you should see the AssetMinder admin interface at /admin.

Next Steps

Make sure to keep your SIMPLASSET_SECRET environment variable secure and never commit it to version control.

On this page