Bisonapp

Abstract

1. Introduction

Echobind is a full-service digital agency that creates web and mobile apps for clients across a variety of industries.

We're experts in React, React Native, Node, GraphQL, and Rails.

Bison is a starter repository created out of real-world apps at Echobind. It represents our team's "Greenfield Web Stack" that we use when creating web apps for clients.

2. Objective

A Full Stack Jamstack in-a-box brought to you by Echobind

This project demonstrates how TypeScript, GraphQL, React can be applied to a real-world Full Stack Web Development problem.

3. Key Features / Modules

• Customizable Hygen Templates to generate new files
• Fully wired up login/signup pages with client and server-side validation.
• Eslint pre-configured with Echobind best practices
• Import path alias to the root project folder (@/) to avoid the need for long relative import paths.
• Set up for components from ui.shadcn.com

4. Technology Stack

• TypeScript
• tRPC API for end-to-end type safety
• Prisma w/ Postgres
• Tailwind
• React Hook Form
• Playwright for E2E tests
• React Testing Library and Jest for unit and API request tests

5. System Requirements

General requirements for this technology stack — check the README for exact versions.

• Node.js (LTS) and npm / yarn / pnpm
• VS Code or any code editor
• Git (to clone the repository)

6. Installation & Setup

git clone https://github.com/echobind/bisonapp.git
cd bisonapp

yarn create bison-app MyApp

npx create-bison-app MyApp

Full setup instructions are in the project README.

7. Future Enhancements

Suggested extensions you can add to make this your own project.

• Add role-based access control
• Deploy on a VPS or cPanel hosting with a custom domain
• Add automated tests and a CI pipeline

8. Viva / Review Questions

Common questions examiners ask for projects in this domain.

1. Explain the frontend, backend and database layers of this application.
2. How is user authentication and authorisation implemented?
3. Describe the main database tables / collections and their relationships.
4. Which REST APIs or routes are exposed and what do they return?
5. How would you deploy this application to production?

9. Source Code & License

This project is developed by echobind and published on GitHub under the MIT License. Please follow the license terms and credit the original author when you use or modify this code.