How kavi-ya/firenext works
Project type and purpose
• This is not a live codebase but a tutorial/documentation repo (“FireNext”) showing how to host a Next.js app on Firebase Hosting with Realtime Database. The actual system being described is a full-stack web application:
• Frontend: Next.js (React) app running in the browser and SSR/SSG build pipeline
• Hosting: Firebase Hosting (serves static assets and can run SSR functions)
• Database: Firebase Realtime Database accessed via Firebase JS SDK
File structure
• Top-level:
• Assets/ – screenshots used in the guide
• README.md – step-by-step instructions
• _config.yml – likely for Jekyll site generation (GitHub Pages)
• .github/workflows/jekyll-gh-pages.yml – CI for publishing the docs site
• There is no actual Next.js code in this repo; the README instructs how to scaffold and deploy one.
README for additional insights
• The README describes:
• Creating a Next.js app via npx create-next-app
• Installing firebase SDK and CLI
• Initializing Firebase Hosting (public folder “out” for static export)
• Configuring and using Firebase Realtime Database
• Build (npm run build) → static export → deploy (firebase deploy)
Don’t overthink—capture every major piece
• Developer tools & source code
• Build output directory
• CI/CD step (firebase deploy)
• Hosting service
• Database service
• Client interactions