Search…
⌃K

Upload

@adminjs/upload
The upload feature helps organize your files and keep information about them in database.
There is possibility to use different storage for files:
  • local filesystem
  • AWS S3
  • Google Cloud Storage
To install the upload feature run:
$ yarn add @adminjs/upload
The main concept of the upload feature is that it sends uploaded files to an external source. The database keeps the information about path and folder name where the file was stored.
The feature uses following terms
  • key is the path of the stored file
  • bucket is the name of the container
First we have to create in our database table where we store information about our files.
Below is written interface for entity. Feel free to add your own fields to store other data connected with file.
interface IFile {
id: number;
s3Key: string;
bucket: string;
mime: string;
comment: string | null;
}
Next, you should decide, where your files will be stored and prepare resource entry for AdminJS
Local Filesystem
AWS S3
Google Cloud Storage
In this example your local server should have established bucket folder and it should be accessible by web browser (via baseUrl path)
app.use(express.static(path.join(__dirname, '../public')));
import uploadFeature from '@adminjs/upload';
import { File } from './models/file';
const localProvider = {
bucket: 'public/files',
opts: {
baseUrl: '/files',
},
};
export const files = {
resource: File,
options: {
properties: {
s3Key: {
type: 'string',
},
bucket: {
type: 'string',
},
mime: {
type: 'string',
},
comment: {
type: 'textarea',
isSortable: false,
},
},
},
features: [
uploadFeature({
provider: { local: localProvider },
validation: { mimeTypes: ['image/png', 'application/pdf', 'audio/mpeg'] },
}),
],
};
import uploadFeature from '@adminjs/upload';
import { File } from './models/file';
const AWScredentials = {
accessKeyId: 'AWS_ACCESS_KEY_ID',
secretAccessKey: 'AWS_SECRET_ACCESS_KEY',
region: 'AWS_REGION',
bucket: 'AWS_BUCKET',
};
export const files = {
resource: File,
options: {
properties: {
s3Key: {
type: 'string',
},
bucket: {
type: 'string',
},
mime: {
type: 'string',
},
comment: {
type: 'textarea',
isSortable: false,
},
},
},
features: [
uploadFeature({
provider: { aws: AWScredentials },
validation: { mimeTypes: ['application/pdf'] },
}),
],
};
import uploadFeature from '@adminjs/upload';
import { File } from './models/file';
const GCScredentials = {
serviceAccount: 'SERVICE_ACCOUNT',
bucket: 'GCP_STORAGE_BUCKET',
expires: 0,
};
export const files = {
resource: File,
options: {
properties: {
s3Key: {
type: 'string',
},
bucket: {
type: 'string',
},
mime: {
type: 'string',
},
comment: {
type: 'textarea',
isSortable: false,
},
},
},
features: [
uploadFeature({
provider: { gpc: GCScredentials },
validation: { mimeTypes: ['image/png'] },
}),
],
};
After that add files resource to AdminJS options config
import { files } from './resources/files';
const adminJsOptions = {
resources: [
//...
files
],
//...
}
If you would like to deal with multiple files with single database entry it will be necessary to modify config files
Entity
Resource
import { BaseEntity, Column, CreateDateColumn, Entity, PrimaryGeneratedColumn, UpdateDateColumn } from 'typeorm';
@Entity({ name: 'files' })
export class File extends BaseEntity {
@PrimaryGeneratedColumn()
public id: number;
@Column({ name: 's3_key', nullable: true, type: 'jsonb' })
public s3Key: string;
@Column({ nullable: true, type: 'jsonb' })
public bucket: string;
@Column({ nullable: true, type: 'jsonb' })
public mime: string;
@Column({ nullable: true, type: 'text' })
public comment: string;
@CreateDateColumn({ name: 'created_at' })
public createdAt: Date;
@UpdateDateColumn({ name: 'updated_at' })
public updatedAt: Date;
}
import uploadFeature from '@adminjs/upload';
import { File } from './models/file';
const localProvider = {
bucket: 'public/files',
baseUrl: '/files',
};
export const files = {
resource: File,
options: {
properties: {
s3Key: {
type: 'string',
isArray: true,
},
bucket: {
type: 'string',
isArray: true,
},
mime: {
type: 'string',
isArray: true,
},
comment: {
type: 'textarea',
isSortable: false,
},
},
},
features: [
uploadFeature({
provider: { local: localProvider },
multiple: true,
validation: { mimeTypes: ['image/png', 'application/pdf', 'audio/mpeg'] },
}),
],
};