Newsletter
Join the Community
Subscribe to our newsletter for the latest news and updates
A Nuxt application with SSR on the edge, authentication and a SQLite database.
Free Bootstrap 4 design system with over 100 components, pre-built pages, and a full UI kit for faster web projects.
Nuxt Guestbook is a boilerplate/demo application built with Nuxt that demonstrates server-side rendering on the edge, GitHub OAuth authentication, and SQLite database storage via Cloudflare D1.
Nuxt Guestbook is an open-source example application built with Nuxt that shows how to combine server-side rendering on the edge, GitHub OAuth authentication, and persistent SQLite storage in a single project. The app runs on Cloudflare Pages through NuxtHub, uses Cloudflare D1 as its production database, and accepts visitor messages that are displayed on a public guestbook page. The project is distributed under the MIT License and includes a live demo at nuxt-guestbook.pages.dev.
npx nuxthub deploy to publish the app to your Cloudflare account; also supports Cloudflare Pages CI.Nuxt developers who want to see a minimal but complete integration of edge SSR, SQLite, and authentication in one codebase. Full-stack developers working with Cloudflare D1 who need a reference for drizzle ORM migrations and query patterns. Also for teams evaluating NuxtHub as a deployment platform for their Nuxt projects. Beginners can use it to learn how to configure GitHub OAuth and session handling in Nuxt.
After cloning the repository, install dependencies with pnpm i, create a GitHub OAuth application with homepage and callback URLs pointing to localhost:3000, then add the required environment variables to a .env file, including NUXT_OAUTH_GITHUB_CLIENT_ID, NUXT_OAUTH_GITHUB_CLIENT_SECRET, and a NUXT_SESSION_SECRET of at least 32 characters. Run npm run dev to start the development server. For production, set the build command to npm run build and the output directory to dist/, then deploy with npx nuxthub deploy.
It uses Cloudflare D1, which is a SQLite database designed to work with Cloudflare's edge network. The README explains that database schema is managed through drizzle ORM migrations, so you can version and apply schema changes just like in a traditional SQL database.
Use npx nuxthub deploy to deploy directly from your local machine to your Cloudflare account. Alternatively, you can set up Cloudflare Pages CI using the build command npm run build and the output directory dist/.
The project uses both Nuxt UI and Nuxt UI Pro. The README includes a NUXT_UI_PRO_LICENSE environment variable, indicating that a Nuxt UI Pro license key is required to run the full component set. Without a license, you may need to replace or remove those components.
Yes, the repository is released under the MIT License, so you can freely use, modify, and distribute the code for personal or commercial purposes.
