Skip to content

kyh/yours-sincerely

Repository files navigation

contributions welcome GitHub last commit Discord

Yours Sincerely

🚀 Website | App Store | Play Store

An ephemeral anonymous blog to send each other tiny beautiful letters. Write as if your arms are wide open, and hold them far apart.

Get Started

The application follows a typical Remix folder structure. You can find the entry point the web application in the app directory.

You'll notice that the Remix routes are just thin wrappers and most of the heavy lifting code is done in the /lib directory. This follows more of a nx/flutter folder structure which helps compartmentalize feature specific code and encourages sharing business logic code between the frontend web and server.

The native code is a capacitor wrapper which can be found in the ios and android directories.

├── /api                     # Remix server
├── /app                     # Frontend client
|   ├── /lib                 # Feature source code (most of the logic lives here)
|   └── /routes              # Remix file sytem routes
├── /ios                     # iOS webview wrapper
├── /android                 # Android webview wrapper
├── /prisma                  # Prisma schema and database associated files
├── /public                  # Static assets
└── /styles                  # Global styles

Install dependencies

  • Node.js - LTS version recommended

Local Development

# Rename .env.example to .env and update variables
mv .env.example .env

# Installing dependencies
npm install

# To start the app
npm run dev

# To run native apps (make sure web server is running with the command above)
npm run native-dev-ios
npm run native-dev-android

This will start the Remix development server. When the above command completes you'll be able to view your website at http://localhost:3000

Stack

This project uses the following libraries and services: