Toggle Menu

Next.js and Astra DB Starter

A sample Next.js + DataStax Astra DB starter app that leverages the Astra DB REST API to manage a character database.

10 minutesBeginner

Updated


Next.js and Astra DB Starter

10 minutes, Beginner, Start Building

A sample Next.js + DataStax Astra DB starter app that leverages the AstraDB REST API to manage a character database.

image

Objectives

  • Provide a fullstack development example using Astra DB as the storage backend

How this works

Once the Astra DB credentials are provided, the necessary tables are created in the database and sample data is inserted. The webservice will be available on port 3000 once the application has been deployed. Once the application is running, you can begin to make changes to your app by editing pages/index.js.

Next.js is an open-source JavaScript framework that lets you build server-side rendering and static web applications using React. It is not nescessary to configuration of webpack or similar to start using Next.js, as it comes with its configuration. This make it very simple to start a project, as we only need to execute simple commands and the project is ready.

Vercel is a cloud platform for static sites and Serverless Functions, it enables developers to host Jamstack websites and web services that deploy instantly. You also have the option to deloy this app in Vercel.

Get Started

To build and play with this app, follow the build instructions that are located here: https://github.com/DataStax-Examples/astra-next.js-starter

Running the Next.js and Astra DB Starter

Follow the instructions below to get started.

Prerequisites

Let's do some initial setup by creating a serverless(!) database.

DataStax Astra

  1. Create a DataStax Astra account if you don't already have one:

image

  1. On the home page. Locate the button Create Database

image

  1. Locate the Get Started button to continue

image

  1. Define a database name, keyspace name and select a database region, then click create database.

image

  1. Your Astra DB will be ready when the status will change from Pending to Active 💥💥💥

image

  1. After your database is provisioned, we need to generate an Application Token for our App. Go to the Settings tab in the database home screen.

image

  1. Select Admin User for the role for this Sample App and then generate the token. Download the CSV so that we can use the credentials we need later.

image

  1. After you have your Application Token, head to the database connect screen and copy the connection information that we'll need later. We'll replace ASTRA_DB_APPLICATION_TOKEN with the Token value that is part of your Application Token.

image

Github

  1. Click Use this template at the top of the GitHub Repository:

image

  1. Enter a repository name and click 'Create repository from template':

image

  1. Clone the repository:

image

🚀 Getting Started Paths:

Make sure you've completed the prerequisites before starting this step

Running on your local machine

  1. cd into the cloned repository. Install Node dependencies with Yarn: yarn install (Alternatively, use npm: npm install)

  2. Run the set up script: . ./gitpod-setup.sh

  3. Start your app by running: yarn start or npm start

  4. You can view your app at http://localhost:3000/:

image

Running on GitPod

  1. Click the 'Open in GitPod' link:

Open in IDE

  1. Wait for your GitPod workspace to start:

image

  1. Set your Astra DB credentials (from prerequisites) in the GitPod terminal at the bottom of the screen:

image

  1. Click the 'Open browser' button in the bottom right of the screen:

image

  1. View your application:

image

Deploying to Vercel

  1. Click the 'Deploy' button:

Deploy with Vercel

  1. Click continue:

image

  1. Install Vercel for Github:

Screen Shot 2020-08-27 at 9 58 50 AM

  1. Enter your Astra DB details and click deploy:

image

  1. Click visit to view your live app:

image

Create your Account and get started!

Let's Go!
View on GitHubDeploy to NetlifyDeploy to Vercel