A beautiful app to remember names and personal details of the people in your life.
- Vite
- TypeScript
- React
- shadcn-ui
- Tailwind CSS
- Neon (Auth, Data API, Object Storage, Functions)
- Clone the repository
- Install dependencies:
npm installorpnpm install - Link the repo to your Neon project (from the repo root):
neon link
- In the Neon Console, enable the services this app needs:
- Auth — note the Auth URL
- Data API — note the Data API URL
- Copy
.env.exampleto.env.localand fill in the values:VITE_NEON_AUTH_URL=your_neon_auth_url_here VITE_NEON_DATA_API_URL=your_neon_data_api_url_here VITE_S3_PUBLIC_ENDPOINT=your_s3_public_endpoint_here VITE_NEON_FUNCTION_URL=your_neon_function_url_here DATABASE_URL=your_database_url_here - Run the development server:
npm run devorpnpm dev
setup_database.sql creates the people table with Row Level Security (four
policies isolating rows per user) and is safe to re-run. Apply it, then refresh
the Data API schema cache:
Option A: Using the Neon CLI
neon psql production --project-id wispy-flower-18622319 --role-name neondb_owner \
-- -v ON_ERROR_STOP=1 -f setup_database.sql
neon data-api refresh-schema --project-id wispy-flower-18622319 --branch productionOption B: Manual Setup (Easier for beginners)
- Go to your Neon project dashboard
- Open the SQL Editor
- Copy and paste the contents of
setup_database.sql - Run the SQL
- Refresh the Data API schema (Neon Console → Data API, or the
neon data-api refresh-schemacommand above)
neon.ts declares the app's Neon services: Auth, Data API, the public-read
profile-images bucket, and the api function (api.ts), which mints
presigned upload URLs. Deploy them with:
neon deployThe printed function URL is the value for VITE_NEON_FUNCTION_URL.
Create a .env.local file with the following variables:
VITE_NEON_AUTH_URL: Your Neon Auth base URL (Neon Console → Auth)VITE_NEON_DATA_API_URL: Your Neon Data API URL (Neon Console → Data API)VITE_S3_PUBLIC_ENDPOINT: The S3 endpoint used to build public image URLsVITE_NEON_FUNCTION_URL: The deployed upload function's URL (fromneon deploy)DATABASE_URL: Your Postgres connection string — only used locally for running migrations
This project is licensed under the GPLv3 License - see the LICENSE file for details.
Please ensure you don't commit sensitive information like API keys or personal data.