https://github.com/developerdavid2/neuralpay
AI-powered financial intelligence platform that connects to your existing bank accounts (read-only) and gives you a clear, AI-driven picture of your financial health.
https://github.com/developerdavid2/neuralpay
Last synced: 8 days ago
JSON representation
AI-powered financial intelligence platform that connects to your existing bank accounts (read-only) and gives you a clear, AI-driven picture of your financial health.
- Host: GitHub
- URL: https://github.com/developerdavid2/neuralpay
- Owner: developerdavid2
- Created: 2026-04-29T18:38:35.000Z (about 2 months ago)
- Default Branch: main
- Last Pushed: 2026-05-30T15:31:09.000Z (18 days ago)
- Last Synced: 2026-05-30T16:12:45.596Z (18 days ago)
- Language: TypeScript
- Homepage:
- Size: 904 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# neuralpay
This project was created with [Better-T-Stack](https://github.com/AmanVarshney01/create-better-t-stack), a modern TypeScript stack that combines Next.js, Express, TRPC, and more.
## Features
- **TypeScript** - For type safety and improved developer experience
- **Next.js** - Full-stack React framework
- **TailwindCSS** - Utility-first CSS for rapid UI development
- **Shared UI package** - shadcn/ui primitives live in `packages/ui`
- **Express** - Fast, unopinionated web framework
- **tRPC** - End-to-end type-safe APIs
- **Bun** - Runtime environment
- **Drizzle** - TypeScript-first ORM
- **PostgreSQL** - Database engine
- **Authentication** - Better-Auth
- **Husky** - Git hooks for code quality
- **Turborepo** - Optimized monorepo build system
## Getting Started
First, install the dependencies:
```bash
bun install
```
## Database Setup
This project uses PostgreSQL with Drizzle ORM.
1. Make sure you have a PostgreSQL database set up.
2. Update your `apps/server/.env` file with your PostgreSQL connection details.
3. Apply the schema to your database:
```bash
bun run db:push
```
Then, run the development server:
```bash
bun run dev
```
Open [http://localhost:3001](http://localhost:3001) in your browser to see the web application.
The API is running at [http://localhost:3000](http://localhost:3000).
## UI Customization
React web apps in this stack share shadcn/ui primitives through `packages/ui`.
- Change design tokens and global styles in `packages/ui/src/styles/globals.css`
- Update shared primitives in `packages/ui/src/components/*`
- Adjust shadcn aliases or style config in `packages/ui/components.json` and `apps/web/components.json`
### Add more shared components
Run this from the project root to add more primitives to the shared UI package:
```bash
npx shadcn@latest add accordion dialog popover sheet table -c packages/ui
```
Import shared components like this:
```tsx
import { Button } from "@neuralpay/ui/components/button";
```
### Add app-specific blocks
If you want to add app-specific blocks instead of shared primitives, run the shadcn CLI from `apps/web`.
## Git Hooks and Formatting
- Initialize hooks: `bun run prepare`
## Project Structure
```
neuralpay/
├── apps/
│ ├── web/ # Frontend application (Next.js)
│ └── server/ # Backend API (Express, TRPC)
├── packages/
│ ├── ui/ # Shared shadcn/ui components and styles
│ ├── api/ # API layer / business logic
│ ├── auth/ # Authentication configuration & logic
│ └── db/ # Database schema & queries
```
## Available Scripts
- `bun run dev`: Start all applications in development mode
- `bun run build`: Build all applications
- `bun run dev:web`: Start only the web application
- `bun run dev:server`: Start only the server
- `bun run check-types`: Check TypeScript types across all apps
- `bun run db:push`: Push schema changes to database
- `bun run db:generate`: Generate database client/types
- `bun run db:migrate`: Run database migrations
- `bun run db:studio`: Open database studio UI