🚀 v1.0.0 Now Available

Podalls Demo

The ultimate full-stack starter template. Auth, Database, Type-safety, and Performance — all pre-configured.

Get StartedGitHubAdmin Dashboard

Demo Instructions

  • Click the Admin Dashboard button above to see the protected admin demo page.
  • Click Sign Out (if logged in) to see the Sign In page.
  • Test all authentication flows: Sign Up, Request Access, and Forgot Password.
  • All of these features are currently in Demo Mode.

Powered by the Best

Built on a foundation of modern, battle-tested technologies.

TanStack Start
Full-stack React framework with top-tier routing and data loading.
BetterAuth
Comprehensive authentication solution for secure user flows.
Neon Database
Serverless PostgreSQL built for the cloud. Fast and scalable.
Drizzle ORM
TypeScript ORM that lets you sleep at night. 100% type-safe.

Features

Everything you need to build production-ready applications.

Secure Authentication

Pre-configured email/password and social login flows.

Lightning Fast

Optimized build and runtime performance with Vite and Bun.

End-to-End Type Safety

From database to frontend, your types are always in sync.

Developer Experience

Hot module replacement, great tooling, and simple configuration.

UI Components

Beautiful, accessible components built with Shadcn UI.

Server Functions

Seamless server-side logic integration with TanStack Start.

Enterprise Ready

Admin & Access Control

A complete invite-only workflow is built-in. Define who gets access to your application.

Access Request Lifecycle

1. User Request

Potential users submit a request via the public /request-access form, providing their email, desired username, and a reason for access.

2. Admin Review

Admins view pending requests in the protected Dashboard. They can review user details and reasons before making a decision.

3. Approval & Onboarding

Upon approval, an account is automatically created. The user receives an email notification (configurable) and can sign in immediately.

Role-Based Protection
Secure admin routes are protected by middleware and client-side checks, ensuring only users with the `admin` role can access sensitive controls.
Detailed Audit
Capture detailed information during the request process, including user justification. Admins can provide rejection notes for feedback.

Getting Started

Follow these steps to get your project up and running.

Prerequisites

Before proceeding, ensure you have the following ready:

  • Neon Database: You will need a PostgreSQL connection string from Neon.
  • Resend API: Obtain an API key and verify your domain at Resend.
1

Clone the repository

git clone https://github.com/podalls/podalls-demo.git
cd podalls-demo
2

Install dependencies

bun install
3

Setup Environment

Copy the example env file and update your credentials.

cp .env.example .env
4

Setup Database

bun db:generate
bun db:push
5

Run Development Server

bun dev