Welcome to Bun-stack, a "full-stack" application template built with TanStack, but with a separate Express back-end. This template is designed to provide a solid foundation for working in a small team for our school project, allowing us to focus on building features rather than setting up the infrastructure. The Express back-end is meant as an example but can be changed out for any back-end you like.

Documentation

This documentation is organized into several sections, each covering a different aspect of the project and how to use these packages effectively, this is in no way the "best" way to do things, but it's light weight and easy to understand boilerplate.

There is also a AGENTS.md file to help you out if you wish to use AI agents to help you with your work, but it's not required. a couple smaller context file for specific topics like routing, queries and forms.

• conventions

• project structure

• router

• query

• auth

• form

• Back-end Setup

How to install pnpm

npm install -g pnpm

(Yes it's that easy, and you wont have to worry about node_modules bloat anymore)

Getting Started

To run this application:

pnpm install
pnpm dev

Building For Production

To build this application for production:

pnpm build

Extras

Testing

This project uses Vitest for testing. You can run the tests with:

pnpm test

Linting & Formatting

This project uses eslint and prettier for linting and formatting. Eslint is configured using tanstack/eslint-config. The following scripts are available:

pnpm lint
pnpm format
pnpm check

Shadcn

Add components using the latest version of Shadcn.

pnpm dlx shadcn@latest add button