Skip to content

feat: Add deploy-fullstack-vercel skill#3348

Merged
alex-nork merged 2 commits into
mainfrom
alex/add-deploy-fullstack-vercel-skill
Feb 17, 2026
Merged

feat: Add deploy-fullstack-vercel skill#3348
alex-nork merged 2 commits into
mainfrom
alex/add-deploy-fullstack-vercel-skill

Conversation

@alex-nork
Copy link
Copy Markdown
Contributor

@alex-nork alex-nork commented Feb 17, 2026

What

Adds a new skill to the Vellum skills catalog: Deploy Fullstack to Vercel 🚀

A reusable workflow for deploying full-stack apps (React/Vite frontend + Python/FastAPI backend) to Vercel as serverless demos. No auth required — meant for demos, portfolio pieces, and quick showcases.

What the skill covers

  • Directory structure for Vercel deploy (static frontend + api/ serverless functions)
  • FastAPI serverless wrapper (api/index.py) with proper sys.path setup
  • SQLite on /tmp with auto-seeding on every cold start (the feat: initialize Next.js app in /web directory #1 gotcha)
  • vercel.json rewrite config for SPA + API routing
  • Gotchas & limitations table (ephemeral storage, CORS, requirements.txt placement, module imports)
  • Vercel CLI quick reference

Why

This was battle-tested during a real deployment of a full-stack personal trainer app (FitForge). The biggest lesson learned: Vercel serverless uses ephemeral /tmp for SQLite, so ALL required data must be seeded on cold start — not just reference data but also any records the frontend expects to exist (like a default user).

How to test

  1. Install the skill: vellum_skills_catalog install deploy-fullstack-vercel
  2. Load it: skill_load deploy-fullstack-vercel
  3. Follow the workflow with any React + FastAPI project

Open with Devin

Adds a reusable skill for deploying full-stack apps (React/Vite frontend +
Python/FastAPI backend) to Vercel as serverless demos.

Covers:
- Vercel deploy directory structure
- FastAPI serverless function wrapper (api/index.py)
- SQLite on /tmp with auto-seeding on cold start
- vercel.json rewrite config for SPA + API routing
- Gotchas: ephemeral storage, CORS, requirements.txt placement
- Vercel CLI quick reference
devin-ai-integration[bot]

This comment was marked as resolved.

…LL.md

Co-authored-by: devin-ai-integration[bot] <158243242+devin-ai-integration[bot]@users.noreply.github.com>
@alex-nork alex-nork merged commit cc1a7b1 into main Feb 17, 2026
1 check passed
@alex-nork alex-nork deleted the alex/add-deploy-fullstack-vercel-skill branch February 17, 2026 00:37
awlevin pushed a commit that referenced this pull request Feb 17, 2026
* feat: add deploy-fullstack-vercel skill

Adds a reusable skill for deploying full-stack apps (React/Vite frontend +
Python/FastAPI backend) to Vercel as serverless demos.

Covers:
- Vercel deploy directory structure
- FastAPI serverless function wrapper (api/index.py)
- SQLite on /tmp with auto-seeding on cold start
- vercel.json rewrite config for SPA + API routing
- Gotchas: ephemeral storage, CORS, requirements.txt placement
- Vercel CLI quick reference

* Update assistant/src/config/vellum-skills/deploy-fullstack-vercel/SKILL.md

Co-authored-by: devin-ai-integration[bot] <158243242+devin-ai-integration[bot]@users.noreply.github.com>

---------

Co-authored-by: devin-ai-integration[bot] <158243242+devin-ai-integration[bot]@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant