Jumpino Studio

Write messy, publish polished. The AI blogging studio for creators.

An open-source, self-hosted Vibe Blogging tool that can be deployed on Vercel with AI-powered writing features, SEO optimization, and template-based design.

Features

• 🎯 Guided Step-Based Workflow - Five-step AI-powered process for creating polished content
• 🤖 AI-Powered Writing - Keyword research, title generation, structure creation, and section writing (LLM API Key is required)
• 🔍 SEO Optimized - Customizable meta tags, Open Graph, structured data, sitemap
• 🎨 Template-Based Design - Handlebars templates for the blog frontend that can be customized
• 🔐 Simple Authentication - Single Admin Backend
• 📚 Content History - Revert to previous versions of intro and sections
• 📱 Responsive Design - Mobile-first, works on all devices

Quick Start

Prerequisites

• A Vercel account
• A GitHub account (for deployment)

Deployment Steps

1. Fork or Clone this Repository

   git clone https://github.com/your-username/jumpino-studio.git
   cd jumpino-studio

2. Deploy to Vercel

   • Go to Vercel
   • Click "New Project"
   • Import your repository
   • Vercel will automatically detect Next.js

3. Set Up Vercel Postgres

   • In your Vercel project dashboard, go to "Storage"
   • Click "Create Database" → "Postgres"
   • Note the connection strings (they'll be auto-added as environment variables)

4. Run Database Schema

   • Go to your Vercel project → Storage → Postgres → "Data" tab
   • Copy the contents of db/schema.sql
   • Paste and run it in the SQL editor

5. Configure Environment Variables In your Vercel project settings → Environment Variables, add:

   Required:

   POSTGRES_URL=<your-vercel-postgres-url>
   BLOG_PASSWORD=<your-secure-password>
   AI_PROVIDER_API_KEY=<your-ai-provider-api-key>
   AI_PROVIDER_API_URL=https://api.deepinfra.com/v1/openai

   Note: Jumpino Studio supports any OpenAI-compatible API (e.g., OpenAI, Google Gemini, OpenPipe Anthropic Proxy, etc.). AI integration is required

Usage

Accessing the Dashboard

1. Visit your deployed site
2. Navigate to /login
3. Enter your BLOG_PASSWORD
4. You'll be redirected to the dashboard

Creating Your First Post

Jumpino Studio uses a guided step-based workflow powered by AI:

1. Keyword Research - Find and validate your primary keyword
2. Brain Dump - Capture your initial thoughts and ideas
3. Title Selection - Choose or generate an engaging title
4. Structure - Generate and select a content outline
5. Writing - Write your content section by section with AI assistance

For detailed workflow instructions, see Workflow Guide.

Documentation

Detailed documentation is available in the docs/ directory:

• Workflow Guide - Step-by-step guide to creating posts
• AI Features - Complete documentation of AI-powered features
• Template Customization - Guide to customizing Handlebars templates
• Troubleshooting - Common issues and solutions
• Development Guide - Local development setup and contribution guide
• Architecture - Project structure and architecture overview

Tech Stack

• Next.js 14 - React framework with App Router
• TypeScript - Type safety
• Tailwind CSS - Utility-first CSS
• Shadcn/ui - Component library
• Handlebars - Template engine
• Vercel Postgres - Database
• AI Provider - OpenAI-compatible API (e.g., OpenAI, Google Gemini, OpenPipe Anthropic Proxy, etc.)

License

This project is open-source and licensed under the GNU General Public License v3.0 (GPLv3).

Contributing

Contributions are welcome! Please feel free to submit a Pull Request. See Development Guide for setup instructions.

Support

For issues and questions, please open an issue on GitHub. Check Troubleshooting for common solutions.