earpengai / laranuxt

Laravel and Nuxt.js boilerplate

Laravel + Nuxt.js Boilerplate

Now supporting Nuxt v3

Examples on using Dark Mode, authentication, and listing data

What is included

• NUXT v3 front end, a progressive Vue.js framework - For Nuxt v2 visit this branch

  • tailvue a collection of components built for Nuxt.js, powered by WindiCSS|TailwindCSS
  • Authentication library to assist with user sessions and logging in/out
  • Example Authentication Middleware

• Laravel - for our API - v9.7.0

  • Model Typer - Generates Typescript interfaces from Laravel Models
  • MetAPI - API helpers and utilities
  • debugbar - awesome debugbar for our API
  • ide-helper - Helper files to enable help with IDE autocompletion

Installation

• clone from GitHub
• run yarn and composer install to install all of your deps
• copy .env.example to .env and configure it to your likings
• TL;DR

git clone [email protected]:fumeapp/laranuxt.git; cd laranuxt; yarn; composer install; cp .env.example .env;

• Feel free to delete excess media in /resources/

Local Environment

• run yarn dev in one terminal for our nuxt dev setup
• run yarn api (alias for ./artisan serve) in another terminal for our laravel API

Api and Authentication

• Api and auth can be accessed via the provided $api library

const { $api } = useNuxtApp()
console.log($api.$user.name);

Authentication

• Take a look at HeaderLoginModal.vue to see how we pass the credentials to our library

  const redirect = await $api.login(result)
  if (redirect) await router.push({path: redirect})

• Once logged on, you have the boolean $api.loggedIn and the object $api.$user

  <img class="w-8 h-8 rounded-full bg-blue-400" :src="$api.$user?.avatar" alt="User Avatar">

API

The API class provides helper functions to easily retrieve, update, and remove data from your Laravel endpoints

• To get a listing/index of data, use $api.index

const users = $api.index<models.Users>('/user', { page: 1 })

• To get an individual by id, use $api.get

const users = $api.get<models.User>('/user/1')

• To update with an id, use $api.put

const result = $api.put<models.User>('/user/1', user)

• To store a new record, use $api.store

const result = $api.store<models.User>('/user', { name: 'Bob', email: '[email protected]' })

• To delete with an id, use $api.delete

const result = $api.delete<models.User>('/user/1')