Fast

The ultimate orchestrator for fullstack TypeScript projects. Spin up your dev environment, load .env variables, and compile everything for production into a single ready-to-deploy folder.

Features

• One-command orchestration: Run frontend and backend concurrently with fast dev.
• Production build: Generate optimized builds for both backend and static frontend under /dist with fast build.
• Built-in environment variables: Auto-loads .env natively with zero dependencies.
• Batteries included:
  • AI integration: Native support for ai (Vercel SDK), @ai-sdk/google, and @ai-sdk/groq.
  • Reactive state management: Fast proxies via valtio.
  • Scheduling: Automate backend tasks with node-cron.
  • Telegram bots: Build bots with grammy — fast and fully typed.
  • Validation: Schemas and validation ready to go with zod.

Installation

Add it to your project as a dev dependency:

pnpm add -D @caprogramacion/fast

Local Development (Linking)

If you're developing the framework locally and want to link it to your project:

1. In the framework root:

pnpm link --global .

2. In your project root:

pnpm link --global @caprogramacion/fast

Recommended Project Structure

my-project/
├── package.json
├── .env
├── frontend/
│   ├── index.html
│   └── src/
└── server/
    └── index.ts

Setup

Add these scripts to your project's package.json:

{
	"scripts": {
		"dev": "fast dev",
		"build": "fast build"
	}
}

Usage

Create a new project

fast init my-project

Create a project with a GitHub repository

fast init my-project -g myusername

Start the development environment

pnpm dev

Build for production

pnpm build

This generates a /dist folder with /dist/frontend (static HTML/JS/CSS) and /dist/server with your compiled backend TypeScript ready to run with Node.js.

Import in your code

import { z, generateText, google, Bot, type ApiResponse } from "@caprogramacion/fast"

const { text } = await generateText({
	model: google("gemini-1.5-flash"),
	prompt: "Hello World"
})