harbor-baas
v0.2.2
Published
AWS-backed authenticated web app scaffolding tool
Readme
Harbor
A complete backend for your web app, deployed to your own AWS account. No AWS knowledge required.
npm install -g harbor-baas
harbor create MyApp # deploy your backend (~2 min)
harbor login # sign in to Harbor Cloud
harbor link # link your AWS account (one-time)
harbor agent # design your database with AI
harbor bootstrap # generate a starter React app
cd myapp-app && npm run dev # working app with login + databaseWhat's in your backend
Every Harbor backend gives you three things, fully configured and ready to use:
- Database — A NoSQL database where you store all your app's data. Create tables, insert rows, query data — all through a simple API.
- Authentication — End-user sign-in and sign-up, out of the box. Email/password works immediately. Add Google, Facebook, or Amazon social login with one command.
- Secure APIs — Your database is accessed through authenticated APIs. Row-Level Security (RLS) ensures users can only see their own data.
Everything runs in your own AWS account. You own it, you can see it, and there's no vendor lock-in.
Core concepts
CLI
The Harbor CLI is how you create and manage backends. Four commands take you from nothing to a working app:
| Command | What it does |
|---|---|
| harbor create | Deploys a complete backend to your AWS account |
| harbor agent | AI-powered chat to design your database schema |
| harbor bootstrap | Generates a React app wired to your backend |
| harbor remove | Tears down a backend and all its resources |
Agent
The Harbor Agent is an AI assistant that helps you design your database. Describe what you're building in plain English, and the agent creates the right tables, columns, and security settings.
You: I'm building a todo app. Users should only see their own todos.
Harbor: I'll create a todos table with RLS enabled so each user only
sees their own rows. Shall I go ahead?
You: yes
Harbor: Done. The todos table is live.Client libraries
Drop-in React components for authentication and database access:
import { HarborProvider, useHarbor, LoginButton } from '@harbor-baas/react'
function App() {
const { user, db } = useHarbor()
// Query your database
const todos = await db.from('todos').select()
const [todo] = await db.from('todos').insert({ title: 'Buy milk' })
}Available for React (@harbor-baas/react) and Next.js (@harbor-baas/next).
Harbor Cloud
Connect your Harbor account to cloud agents like Vercel v0, Lovable, and Bolt. They can create and manage backends in your AWS account through the Harbor API. See Harbor Cloud commands.
Prerequisites
- Node.js 20+
- AWS account with credentials configured (
~/.aws/credentialsor environment variables)
Documentation
- Getting Started — Build your first app in 5 minutes
- CLI Reference — All commands and options
- Architecture — What Harbor deploys to your AWS account
- @harbor-baas/react — React library reference
- @harbor-baas/next — Next.js library reference
