Vibe Coding Starter Kit
Starter kit for vibe coders building apps with file uploads and object storage. This full-stack dashboard template integrates with Backblaze B2 Cloud Storage and includes secure upload flows, file browsing, and basic storage management.
Built for: Developers and AI-assisted builders who want a working full-stack foundation for an application centered on file uploads and object storage.
What it's built with
Each piece of the stack, and the job it does in this project.
- Next.js 16 + React 19
- Web application and dashboard UI
- Tailwind CSS v4 + shadcn/ui
- Design tokens and reusable interface primitives
- TanStack Query
- Client-side data fetching and cache management
- FastAPI + Pydantic
- Typed Python API and configuration validation
- boto3 + Backblaze B2
- S3-compatible object storage access
- pnpm workspaces
- TypeScript and Python monorepo workflow
Core capabilities
What the project does out of the box, before you write any code of your own.
Working dashboard foundation
Start with responsive navigation, storage statistics, upload activity, recent files, and a reusable design system instead of a blank application shell.
B2-backed file workflows
Upload with progress, browse stored objects, preview supported files, download content, delete objects, and extract useful file metadata.
Typed frontend and API
A Next.js frontend and layered FastAPI service provide a checked API contract, startup validation, and contained B2 SDK access.
Agent-ready repository context
Bounded agent instructions, architecture documentation, feature contracts, and mechanically enforced boundaries help coding agents make safer changes.
Operational starting points
Health and metrics endpoints, structured request logging, rate limiting, upload validation, tests, and verification commands establish a practical baseline.
A closer look
More screens from the running project.
Choose it for the right job
Vibe Coding Starter Kit is a head start for a specific shape of project, not a supported, general-purpose product.
Use it when
- Your application needs uploads, file browsing, or object storage as a central workflow.
- You want a full-stack TypeScript and Python starting point instead of assembling a dashboard and storage layer from scratch.
- You plan to extend the product with an AI coding agent and value explicit repository context and enforced architecture boundaries.
- You are prepared to review and adapt a reference implementation for your own deployment and security requirements.
Choose another path when
- You need a supported product, guaranteed maintenance, or a service-level agreement.
- A static site, a single script, or a framework without a Python service would be a better fit.
- You need production authentication, multi-tenancy, authorization policies, or compliance controls to work without further engineering.
- You cannot operate both a Next.js frontend and a FastAPI backend or do not want a monorepo.
Project status and support
This is an unsupported open source template provided as a starting point. It has no service-level agreement (SLA) or guaranteed support. Review, test, secure, and operate your adapted application for your own requirements.