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
-
Install dependencies:
pnpm install
-
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
-
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
-
Run database migrations:
pnpm db:push
-
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.
Learn More
To learn more about the T3 Stack, take a look at the following resources:
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.
