Skip to content

arashsheyda/nuxt-neo4j

Repository files navigation

nuxt-neo4j

Nuxt Neo4j

npm version npm downloads License Nuxt

Effortlessly integrate Neo4j powerful graph database into your Nuxt applications!

Features

  • Effortless Integration: Set up a database with just one line of configuration.
  • DevTools Support: you will be able to access neo4j's workspace from Nuxt DevTools!
  • Easy to Use: The module provides a useDriver function for easy interaction with the database.
  • Developer Experience: this module is using the official neo4j-driver so it has full support of typescript.

Setup

  1. Add nuxt-neo4j dependency to your project
npx nuxi@latest module add neo4j
  1. Add nuxt-neo4j to the modules section of nuxt.config.ts
export default defineNuxtConfig({
  modules: [
    'nuxt-neo4j',
  ],
})

That's it! You can now use Nuxt Neo4j in your Nuxt app ✨

Configuration

export default defineNuxtConfig({
  neo4j: {
    uri: 'string', // @default: process.env.NEO4J_URI
    auth: {
      type: 'string', // @default: 'basic'
      username: 'string', // @default: process.env.NEO4J_USERNAME
      password: 'string', // @default: process.env.NEO4J_PASSWORD
    },
  },
})

Usage

Once configured, you can start using the Neo4j driver provided by the module in your Nuxt application. Here's an example of how to use it:

export default defineEventHandler(async () => {
  const { records } = await useDriver().executeQuery('MATCH (q:User) RETURN q LIMIT 25;')
  return records
})

for more information please check neo4j documentation

Development

# Install dependencies
pnpm install

# Generate type stubs
pnpm run dev:prepare

# Develop with the playground
pnpm run dev

# Build the playground
pnpm run dev:build

# Run ESLint
pnpm run lint

# Run Vitest
pnpm run test
pnpm run test:watch

# Release new version
pnpm run release