Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

13 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ShipAI

Ship your AI tool in 1 hour, not 1 week. The boilerplate that handles API keys, streaming, UI, SEO, and deployment. You just write prompts.

Live: https://eeyzs1.github.io/shipai/ | Price: $199 one-time | By: Sulynn AI

What you get

A complete, config-driven boilerplate for building AI tools powered by any OpenAI-compatible API (DeepSeek by default). Pure frontend - no backend, no servers, no build step. Deploy to GitHub Pages for free.

Quick start

  1. Clone or download this repo after purchase
  2. Edit template/config.js - define your modes, prompts, branding, UI text
  3. Push to GitHub - create a new repo, push the template/ contents
  4. Enable GitHub Pages - Settings → Pages → Source: main branch
  5. Your tool is live - share the URL, start building in public

That's it. No npm install. No build step. No backend to deploy.

File structure

template/
├── index.html      # Tool page structure (rarely edit)
├── app.js          # Core engine - API calls, streaming, UI (rarely edit)
├── config.js       # YOUR config - modes, prompts, branding (EDIT THIS)
└── style.css       # Styles complementing Tailwind (optional edit)

What's included

Feature Description
API key management localStorage, show/hide toggle, validation, auto-save
Streaming output SSE parsing, cross-chunk buffering, AbortController stop
Responsive UI Header, hero, config, input/output, toast, status bar
SEO ready Meta tags, Open Graph, Twitter Card, JSON-LD structured data
Config-driven Edit ONE file - engine auto-generates mode cards, labels
Zero-cost deploy Static files → GitHub Pages / Vercel / Netlify
Copy & toast One-click copy with fallback, toast for all states
Error handling 401/402/429 mapping, network errors, abort, empty responses
Accessible Semantic HTML, ARIA labels, keyboard friendly

Customizing config.js

window.AI_TOOL_CONFIG = {
  brand: {
    name: 'Your Brand',
    toolName: 'AI Writing Tool',
    primaryColor: '#2563eb',
  },
  api: {
    endpoint: 'https://api.deepseek.com/v1/chat/completions',
    model: 'deepseek-chat',
  },
  modes: [
    {
      id: 'standard',
      label: 'Standard',
      description: 'Balanced output',
      temperature: 0.7,
      systemPrompt: 'You are a helpful assistant...',
    },
    // Add as many modes as you want - UI generates automatically
  ],
  ui: { /* labels, placeholders, button text */ },
  seo: { /* title, description, keywords, url */ },
  faq: [ /* Q&A pairs for SEO schema */ ],
};

Using a different LLM

The engine calls any OpenAI-compatible /v1/chat/completions endpoint. To switch:

api: {
  endpoint: 'https://api.openai.com/v1/chat/completions',
  model: 'gpt-4o-mini',
}

Works with: OpenAI, Anthropic (via proxy), local models (Ollama, LM Studio), Azure OpenAI, etc.

Deployment options

Platform Cost Setup
GitHub Pages Free Push to repo → Settings → Pages
Vercel Free Import repo → Deploy
Netlify Free Drag & drop folder
Cloudflare Pages Free Connect repo → Deploy

License

This boilerplate is licensed for your use. You may:

  • ✅ Build unlimited personal and commercial projects
  • ✅ Modify the code for your needs
  • ✅ Sell products built with this boilerplate

You may NOT:

  • ❌ Resell or redistribute the boilerplate itself
  • ❌ Include this boilerplate in another product/template

Support

Build in Public

This project is built in public. Revenue, failures, and process are shared openly.

Date Milestone Revenue Notes
2026-08-03 Launched ShipAI v1.0 $0 Product live, Creem checkout wired up
2026-08-03 Renamed from AI Tool Boilerplate → ShipAI $0 GitHub repo, landing page, Creem all updated
2026-08-03 Live Payments pending review $0 KYC submitted, waiting for Creem team approval

Distribution channels (no X/Twitter - building through GitHub + Dev.to + IH + Reddit):

  • GitHub - primary channel, updates in README
  • Indie Hackers - progress posts
  • Dev.to - technical articles with product links
  • Reddit - r/SideProject, r/SaaS, r/indiehackers

Built by

Sulynn AI - solo developer with 8 years of AI full-stack experience. Built 7 AI tool sites with this exact stack, then distilled the common code into this boilerplate.

About

ShipAI - Ship your AI tool in 1 hour. Config-driven boilerplate for AI tools. one-time.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages