Create T3 App

This is a T3 Stack project bootstrapped with create-t3-app.

Getting Started

Prerequisites

• Node.js (v18 or higher)
• pnpm (package manager)
• Docker Desktop for Windows (or Docker/Podman on Linux/macOS)

Setup

1. Install dependencies:

   pnpm install
   

2. Set up environment variables:

   • Copy .env.example to .env (if it doesn't exist)
   • Update the DATABASE_URL in .env to match your database configuration
   • Add your Discord OAuth credentials for authentication

3. Start the database:

   On Windows (PowerShell):

   .\start-database.ps1
   

   On Windows (WSL/Linux) or macOS/Linux:

   docker-compose up -d
   

   Or use the provided script:

   ./start-database.sh
   

4. Run database migrations:

   pnpm db:push
   

5. Start the development server:

   pnpm dev
   

The app will be available at http://localhost:3000.

Note: The dev server now runs on 0.0.0.0:3000 to allow mobile devices on your local network to access it.

Database Management

• Start database: docker-compose up -d
• Stop database: docker-compose down
• View logs: docker-compose logs -f postgres
• Open Drizzle Studio: pnpm db:studio

What's next? How do I make an app with this?

We try to keep this project as simple as possible, so you can start with just the scaffolding we set up for you, and add additional things later when they become necessary.

If you are not familiar with the different technologies used in this project, please refer to the respective docs. If you still are in the wind, please join our Discord and ask for help.

• Next.js

• Prisma

• Drizzle

• Tailwind CSS

• tRPC

Learn More

To learn more about the T3 Stack, take a look at the following resources:

• Documentation
• Learn the T3 Stack — Check out these awesome tutorials

You can check out the create-t3-app GitHub repository — your feedback and contributions are welcome!

Installing on a device

ForemanHQ is an installable web app. Open the deployed app and use the Install button in the main bar or Settings. The retired Capacitor wrapper is recoverable from Git history.