Usage in a frontend repository | laravel-medialibrary-pro | Spatie SPATIE laravel-medialibrary-pro ======================== spatie.be/open-source [Docs](https://spatie.be/docs) [Laravel-medialibrary-pro](https://spatie.be/docs/laravel-medialibrary-pro/v6) Advanced Usage in a frontend repository Version v6 Other versions for crawler [v6](https://spatie.be/docs/laravel-medialibrary-pro/v6) - [ Introduction ](https://spatie.be/docs/laravel-medialibrary-pro/v6/introduction) - [ Requirements ](https://spatie.be/docs/laravel-medialibrary-pro/v6/requirements) - [ License ](https://spatie.be/docs/laravel-medialibrary-pro/v6/license) - [ Getting help ](https://spatie.be/docs/laravel-medialibrary-pro/v6/getting-help) - [ Upgrading ](https://spatie.be/docs/laravel-medialibrary-pro/v6/upgrading) - [ About us ](https://spatie.be/docs/laravel-medialibrary-pro/v6/about-us) - [ ](https://spatie.be/docs/laravel-medialibrary-pro/v6/demo-application) Blade ----- - [ Installation ](https://spatie.be/docs/laravel-medialibrary-pro/v6/blade/installation) - [ Usage ](https://spatie.be/docs/laravel-medialibrary-pro/v6/blade/usage) Livewire -------- - [ Installation ](https://spatie.be/docs/laravel-medialibrary-pro/v6/livewire/installation) - [ Attachments ](https://spatie.be/docs/laravel-medialibrary-pro/v6/livewire/attachments) - [ Collection ](https://spatie.be/docs/laravel-medialibrary-pro/v6/livewire/collection) - [ Uploading to S3 ](https://spatie.be/docs/laravel-medialibrary-pro/v6/livewire/uploading-to-s3) React ----- - [ Installation ](https://spatie.be/docs/laravel-medialibrary-pro/v6/react/installation) - [ Usage ](https://spatie.be/docs/laravel-medialibrary-pro/v6/react/usage) - [ Available props ](https://spatie.be/docs/laravel-medialibrary-pro/v6/react/available-props) - [ Inertia ](https://spatie.be/docs/laravel-medialibrary-pro/v6/react/inertia) - [ Next.js ](https://spatie.be/docs/laravel-medialibrary-pro/v6/react/nextjs) - [ Translations ](https://spatie.be/docs/laravel-medialibrary-pro/v6/react/translations) - [ Vapor support ](https://spatie.be/docs/laravel-medialibrary-pro/v6/react/vapor) - [ Creating custom components ](https://spatie.be/docs/laravel-medialibrary-pro/v6/react/creating-custom-components) Vue.js ------ - [ Installation ](https://spatie.be/docs/laravel-medialibrary-pro/v6/vue/installation) - [ Usage ](https://spatie.be/docs/laravel-medialibrary-pro/v6/vue/usage) - [ Available props ](https://spatie.be/docs/laravel-medialibrary-pro/v6/vue/available-props) - [ Inertia ](https://spatie.be/docs/laravel-medialibrary-pro/v6/vue/inertia) - [ Translations ](https://spatie.be/docs/laravel-medialibrary-pro/v6/vue/translations) - [ Vapor support ](https://spatie.be/docs/laravel-medialibrary-pro/v6/vue/vapor) - [ Creating custom components ](https://spatie.be/docs/laravel-medialibrary-pro/v6/vue/creating-custom-components) Security -------- - [ Authorisation ](https://spatie.be/docs/laravel-medialibrary-pro/v6/security/authorisation) - [ Configure allowed mime types ](https://spatie.be/docs/laravel-medialibrary-pro/v6/security/allowed-mime-types) - [ Rate limiting ](https://spatie.be/docs/laravel-medialibrary-pro/v6/security/rate-limiting) Advanced -------- - [ Customizing CSS ](https://spatie.be/docs/laravel-medialibrary-pro/v6/advanced/customizing) - [ Customize the preview images ](https://spatie.be/docs/laravel-medialibrary-pro/v6/advanced/custom-preview-images) - [ Customize the upload URL ](https://spatie.be/docs/laravel-medialibrary-pro/v6/advanced/customiz-upload-url) - [ Usage in a frontend repository ](https://spatie.be/docs/laravel-medialibrary-pro/v6/advanced/usage-in-a-frontend-repository) Legacy ------ - [ Livewire 2 ](https://spatie.be/docs/laravel-medialibrary-pro/v6/legacy/livewire-2) - [ Laravel Mix ](https://spatie.be/docs/laravel-medialibrary-pro/v6/legacy/laravel-mix) Usage in a frontend repository ============================== ### On this page 1. [ Registering with GitHub Packages ](#content-registering-with-github-packages) 2. [ Downloading the packages from GitHub Packages ](#content-downloading-the-packages-from-github-packages) If you can't install the package using `composer` because, for example, you're developing an SPA, you can download the packages from GitHub Packages. Registering with GitHub Packages -------------------------------------------------------------------------------------------------------------------------------------------------------- You will need to create a Personal Access Token with the `read:packages` permission on the GitHub account that has access to the [spatie/laravel-medialibrary-pro](https://github.com/spatie/laravel-medialibrary-pro) repository. We suggest creating an entirely new token for this and not using it for anything else. You can safely share this token with team members as long as it has only this permission. Sadly, there is no way to scope the token to only the Media Library Pro repository. Next up, create a `.npmrc` file in your project's root directory, with the following content: *.npmrc* ``` //npm.pkg.github.com/:_authToken=github-personal-access-token-with-packages:read-permission @spatie:registry=https://npm.pkg.github.com ``` Make sure the plaintext token does not get uploaded to GitHub along with your project. Either add the file to your `.gitignore` file, or set the token in your `.bashrc` file as an ENV variable. *.bashrc* ``` export GITHUB_PACKAGE_REGISTRY_TOKEN=token-goes-here ``` *.npmrc* ``` //npm.pkg.github.com/:_authToken=${GITHUB_PACKAGE_REGISTRY_TOKEN} @spatie:registry=https://npm.pkg.github.com ``` Alternatively, you can use `npm login` to log in to the GitHub Package Registry. Fill in your GitHub credentials, using your Personal Access Token as your password. ``` npm login --registry=https://npm.pkg.github.com --scope=@spatie ``` If you get stuck at any point, have a look at [GitHub's documentation on this](https://docs.github.com/en/free-pro-team@latest/packages/publishing-and-managing-packages/installing-a-package). Downloading the packages from GitHub Packages ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- Now, you can use `npm install --save` or `yarn add` to download the packages you need. ``` yarn add @spatie/media-library-pro-styles @spatie/media-library-pro-vue3-attachment ``` **You will now have to include the `@spatie/` scope when importing the packages**, this is different from examples in the documentation. ``` import { MediaLibraryAttachment } from '@spatie/media-library-pro-vue3-attachment'; ``` You can find a list of all the packages on the repository: https://github.com/orgs/spatie/packages?repo\_name=laravel-medialibrary-pro.