rsnext/examples/with-mysql
Allen Hai 3478e1d0cc
[examples] Add Next.js + MySQL example (#19452)
* [examples] add with-mysql example

* [examples] add demo link to with-mysql readme

* [examples] add next.js + mysql example with correct env pattern

* [examples] fix lint errors, update package name, remove unnecessary res statement

* [examples] remove unused imports and variables

* [examples] fix some linting errors

* Added NextApiHandler to API endpoints

* Lint fixes

* Added useEntry hook

* Updated type

* Update examples/with-mysql/package.json

* Updated readme

* fixed URL

Co-authored-by: Matthew Sweeney <mail@mcs.dev>
Co-authored-by: Luis Alvarez <luis@vercel.com>
2020-11-23 19:13:09 -05:00
..
components [examples] Add Next.js + MySQL example (#19452) 2020-11-23 19:13:09 -05:00
lib [examples] Add Next.js + MySQL example (#19452) 2020-11-23 19:13:09 -05:00
pages [examples] Add Next.js + MySQL example (#19452) 2020-11-23 19:13:09 -05:00
scripts [examples] Add Next.js + MySQL example (#19452) 2020-11-23 19:13:09 -05:00
styles [examples] Add Next.js + MySQL example (#19452) 2020-11-23 19:13:09 -05:00
.env.local.example [examples] Add Next.js + MySQL example (#19452) 2020-11-23 19:13:09 -05:00
.gitignore [examples] Add Next.js + MySQL example (#19452) 2020-11-23 19:13:09 -05:00
next-env.d.ts [examples] Add Next.js + MySQL example (#19452) 2020-11-23 19:13:09 -05:00
package.json [examples] Add Next.js + MySQL example (#19452) 2020-11-23 19:13:09 -05:00
postcss.config.js [examples] Add Next.js + MySQL example (#19452) 2020-11-23 19:13:09 -05:00
README.md [examples] Add Next.js + MySQL example (#19452) 2020-11-23 19:13:09 -05:00
tailwind.config.js [examples] Add Next.js + MySQL example (#19452) 2020-11-23 19:13:09 -05:00
tsconfig.json [examples] Add Next.js + MySQL example (#19452) 2020-11-23 19:13:09 -05:00

MySQL Example

This is an example of using MySQL in a Next.js project.

Demo

https://next-mysql.vercel.app

Deploy your own

Once you have access to the environment variables you'll need, deploy the example using Vercel:

Deploy with Vercel

How to use

Execute create-next-app with npm or Yarn to bootstrap the example:

npx create-next-app --example with-mysql next-mysql-app
# or
yarn create next-app --example with-mysql next-mysql-app

Configuration

Step 1. Set up a MySQL database

Set up a MySQL server either locally or any cloud provider.

Step 2. Set up environment variables

Copy the env.local.example file in this directory to .env.local (which will be ignored by Git):

cp .env.local.example .env.local

Set each variable on .env.local:

  • MYSQL_HOST - Your MySQL host URL.
  • MYSQL_DATABASE - The name of the MySQL database you want to use.
  • MYSQL_USERNAME - The name of the MySQL user with access to database.
  • MYSQL_PASSWORD - The passowrd of the MySQL user.

Step 3. Run migration script

You'll need to run a migration to create the necessary table for the example.

npm run migrate
# or
yarn migrate

Step 4. Run Next.js in development mode

npm install
npm run dev
# or
yarn install
yarn dev

Your app should be up and running on http://localhost:3000! If it doesn't work, post on GitHub discussions.

Deploy on Vercel

You can deploy this app to the cloud with Vercel (Documentation).

Deploy Your Local Project

To deploy your local project to Vercel, push it to GitHub/GitLab/Bitbucket and import to Vercel.

Important: When you import your project on Vercel, make sure to click on Environment Variables and set them to match your .env.local file.

Deploy from Our Template

Alternatively, you can deploy using our template by clicking on the Deploy button below.

Deploy with Vercel