Tailr

Tailr is a full-stack social discovery app for urban places. It combines a React + Vite client with an Express API, using PostgreSQL (via Drizzle ORM and Neon) for persistence.

Table of Contents

• Overview
• Tech Stack
• Repository Structure
• Getting Started
• Environment Variables
• Available Scripts
• Database and Schema
• API Overview
• Deployment
• Troubleshooting
• Contributing
• License

Overview

Tailr provides:

• Place discovery and search
• User accounts with session-based authentication
• Social features (posts, comments, likes, follows, saved places)
• Lists, reviews, notifications, and story-like content
• Community place photo uploads (with optional Replit Object Storage integration)

The app runs as a single Node.js service that serves both:

• JSON API routes under /api/*
• The web client (Vite middleware in development, static assets in production)

Tech Stack

Backend

• Node.js (recommended: 20.x)
• Express
• TypeScript
• Drizzle ORM
• Neon serverless PostgreSQL driver
• Session auth with express-session + memorystore

Frontend

• React 19
• Vite 7
• Wouter
• TanStack Query
• Tailwind CSS 4
• Leaflet / React Leaflet

Tooling

• tsx for TypeScript runtime scripts
• esbuild for server bundling in production builds
• drizzle-kit for database schema push

Repository Structure

.
|- client/                     # React app (UI, routes, hooks, components)
|- server/                     # Express app, API routes, auth, storage layer
|- shared/                     # Shared Drizzle schema + Zod insert schemas
|- script/                     # Build pipeline script (client + server outputs)
|- scripts/                    # Operational shell scripts (for example post-merge)
|- attached_assets/            # Static assets served by Express
|- drizzle.config.ts           # Drizzle configuration
|- vite.config.ts              # Vite config (dev + build outDir)
|- tsconfig.json               # TypeScript config + path aliases
`- .replit                     # Replit runtime and deployment config

Getting Started

Prerequisites

• Node.js 20.x
• npm 9+ (or compatible)
• A PostgreSQL database URL (DATABASE_URL)

1) Install dependencies

npm install

2) Configure environment variables

Create a local environment file or set environment variables in your shell/hosting provider.

# Example .env values
DATABASE_URL=postgres://user:password@host:5432/dbname
SESSION_SECRET=replace-with-a-long-random-secret
PORT=5000
NODE_ENV=development
GOOGLE_API_KEY=optional

3) Apply schema to your database

npm run db:push

4) Start development server

npm run dev