Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/trpc/zart
đ¤¯ zART-stack â Zero-API, React [Native], & TypeScript
https://github.com/trpc/zart
android expo ios react trpc
Last synced: 12 days ago
JSON representation
đ¤¯ zART-stack â Zero-API, React [Native], & TypeScript
- Host: GitHub
- URL: https://github.com/trpc/zart
- Owner: trpc
- Archived: true
- Created: 2021-09-09T23:23:51.000Z (about 3 years ago)
- Default Branch: main
- Last Pushed: 2022-09-28T17:26:01.000Z (about 2 years ago)
- Last Synced: 2024-08-01T15:19:43.236Z (3 months ago)
- Topics: android, expo, ios, react, trpc
- Language: TypeScript
- Homepage: https://twitter.com/alexdotjs
- Size: 465 KB
- Stars: 700
- Watchers: 10
- Forks: 36
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
Awesome Lists containing this project
README
âšī¸âšī¸âšī¸ This example project is not actively maintained and is using an old version (v9) of tRPC âšī¸âšī¸âšī¸
If you're looking for alternatives, have a look at https://github.com/t3-oss/create-t3-turbo and other reference projects on https://trpc.io/docs/awesome-trpc
---
# zART-Stack đ¤¯
> **Z**ero-**A**PI, **R**eact, & **T**ypeScript
**âĄī¸ Probably the fastest way to build a React Native app with your own backend âĄī¸**
## Introduction
A monorepo containing:
- Next.js web app
- React Native app with Expo
- A [tRPC](https://trpc.io)-API which is inferred straight into the above.
- [Prisma](http://prisma.io/) as a typesafe ORM
> In tRPC you simply write API-functions that are automatically inferred straight into your frontend - no matter if it's React, React Native, or something else _(that is TS/JS-based)_.
### Video
> Very rough video recorded in 2 minutes đ
[](http://www.youtube.com/watch?v=dLLm6hgMhMQ "Video Title")
## Requirements
You will need docker compose to run the postgres database.
It comes with the [Docker Desktop App](https://docs.docker.com/get-docker/)
## Getting started
```bash
git clone [email protected]:KATT/zart.git
cd zart
yarn
yarn dev
```
> Press `i` after `yarn dev` in to launch the iOS Simulator.
Now - head over to one of the [`./apps`](./apps), whilist updating [a router in tRPC](./packages/api/src/routers) or the [Database Schema](./prisma/schema.prisma) and see that the data is directly inferred.
## Available commands
| Command | Description |
| --------------------- | ---------------------------------------------------------------------------------------------- |
| `yarn dev` | Starts Postgres, Expo & Next.js |
| `yarn db-up` | Starts Postgres on port `5466` |
| `yarn db-migrate-dev` | Runs the latest Database migrations after updating the [Prisma schema](./prisma/schema.prisma) |
| `yarn db-nuke` | Stops and deletes the the database |
## Folder structure
```graphql
.
âââ apps
â âââ expo # Expo/RN application
â âââ nextjs # Server-side rendered Next.js application
âââ packages
â âââ api # tRPC API
â âââ react # Shared React-helpers
â âââ react-native # RN components. **Could** be shared between Expo & Next.js if you're in to that sort of thing.
âââ prisma # Prisma setup
```
## Further reading
### Deployment
#### Vercel
- Create a Postgres Database
- Set env `DATABASE_URL` pointing towards that db
- Configure *"Root Directory"* as `apps/nextjs` and tick _Include source files outside of the Root Directory in the Build Step_.
### Questions?
Shoot me a message [on Twitter](https://twitter.com/alexdotjs)!
## Credits
- tRPC and this example is made by [@alexdotjs](https://twitter.com/alexdotjs)
- `apps/expo` is basically a copy-paste from [`expo-next-monorepo-example`](https://github.com/axeldelafosse/expo-next-monorepo-example) by [axeldelafosse](https://github.com/axeldelafosse).