Skip to content

adamsondavid/tapw

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

443 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Tap Water πŸ’§

A fast, fullstack Vue.js template for serverless and Docker environments.

Build modern fullstack Vue apps with end-to-end type safety and a focus on developer experience. Deploy effortlessly to the cloud in seconds with first-class support for popular providers πŸš€

Overview

tapwater is an opinionated fullstack template designed to jumpstart your development with minimal setup. It provides a robust stack that prioritizes performance, scalability, and an optimal developer workflow. Whether you're deploying to serverless environments like Vercel, Netlify, or Cloudflare, or spinning up a Docker container in the cloud, tapwater has you covered.

Fork, modify, and make it your own!

✨ Key Features

  • Vue 3 powered frontend with Vite for fast builds and HMR.
  • Tailwind CSS and Shadcn for rapid and flexible UI development.
  • A fully integrated backend, powered by web standards.
  • End-to-end type safety with TypeScript across both the frontend and backend.
  • Cypress for robust e2e testing.
  • Focus on DX: fast local development and seamless deployments.
  • Optimized for serverless platforms like Cloudflare, Vercel, Deno Deploy, and Netlify. Easy Docker deployment for environments that support containers.

⚠️ Limitations

No Server-Side Rendering: This template only supports Vue.js as a traditional Single Page Application. SSR is out of scope. Please do not use this template in production if you care about features like SEO.

πŸ› οΈ Supported Deployment Providers

This project is based on Nitro, which allows you to turn any Vite-based application into a fullstack app. Nitro's strength lies in the ability to transform any Vite-based application into a Build Output API-compliant format for many cloud providers. The following list includes just a few of them that we've verified work well:

  • Cloudflare Workers
  • Vercel
  • Deno Deploy
  • Netlify
  • Heroku-like Platforms: Works with platforms that follow Heroku's conventions (e.g., npm ci && npm run build, followed by npm run start).
  • Docker: Package and deploy anywhere Docker runs using one of our Node, Bun, or Deno-backed Dockerfiles.

Important

For hobby projects: We recommend Cloudflare due to its excellent free tier, which includes unlimited bandwidth, 100,000 function invocations per day, allowance for commercial use, and no unexpected charges when exceeding limits.

🎬 Live Demos

Check out tapwater in action across various providers:

πŸš€ Get Started

  1. Click "Use this template": create your own repo based on this template
  2. Clone the repo: git clone git@github.com:your-username/your-repo.git && cd your-repo
  3. Install dependencies: npm install
  4. Develop locally: npm run dev
  5. Deploy: Log in to Cloudflare, Vercel, Deno Deploy, Netlify, or Heroku(-like) and import the project. The platforms should recognize most config parameters automatically (check Nitro Docs for details). If you want to deploy the application as a container, check out our Node, Bun, and Deno based Dockerfiles.

πŸ“„ License

This project is licensed under the MIT License. Feel free to fork, modify, and share your creations! Please make sure to include this repository's license in your distribution.

About

A template for building fullstack Vue apps with e2e typesafety and DX in mind. Deploy to the cloud within seconds πŸš€

Topics

Resources

License

Stars

Watchers

Forks

Contributors