fix: improve env onboarding and dev error messages

.env.example

@@ -0,0 +1,3 @@
+ADMIN_DOMAIN = http://localhost:9001
+DATABASE_URL = postgresql://postgres:postgres@localhost:5432/nextplacement
+AUTH_SECRET= change_me_to_a_long_random_string

README.md

@@ -1,28 +1,31 @@
-# NextPlacement
+# shadcn/ui monorepo template
 
-NextPlacement is a placement-management platform built as a monorepo (pnpm workspaces + Turborepo) with multiple apps and shared packages.
+This template is for creating a monorepo with shadcn/ui.
 
-## Repository Layout
+## Usage
-- `apps/` - application(s) (e.g., student/admin web apps)
 
-- `packages/` - reusable packages/libraries used by apps
-
-- `shared/` - sared code/assets (project-specific)
-
-- `docker-compose.yml` / `docker-compose.dev.yml` - Docker compose configurations
-
-- `DOCKER.md` - Docker notes / commands
-
-## Prerequisites
-- Git
-- Node.js (LTS recommended)
-- pnpm
-- Docker Desktop (recommended for easiest setup)
-
-## Quick Start (Docker)
-1. Create environment file:
-- Create `.env` in the project root (or copy from `.env.example` if present)
-
-2.Start containers:
 ```bash
-docker-compose up --build
+pnpm dlx shadcn@latest init
+```
+
+## Adding components
+
+To add components to your app, run the following command at the root of your `web` app:
+
+```bash
+pnpm dlx shadcn@latest add button -c apps/web
+```
+
+This will place the ui components in the `packages/ui/src/components` directory.
+
+## Tailwind
+
+Your `tailwind.config.ts` and `globals.css` are already set up to use the components from the `ui` package.
+
+## Using components
+
+To use the components in your app, import them from the `ui` package.
+
+```tsx
+import { Button } from '@workspace/ui/components/button';
+```

apps/admin/.env.example

@@ -1,2 +0,0 @@
-DATABASE_URL=postgresql://postgres:postgres@localhost:5432/nextplacement
-AUTH_SECRET=change_me

apps/student/.env.example

@@ -1,3 +0,0 @@
-ADMIN_DOMAIN=http://localhost:9001
-DATABASE_URL=postgresql://postgres:postgres@localhost:5432/nextplacement
-AUTH_SECRET=change_me

apps/student/next.config.mjs

@@ -2,6 +2,7 @@
 import path from 'path';
 
 const __dirname = path.resolve();
+const adminDomain = process.env.ADMIN_DOMAIN || "http://localhost:9001";
 
 const nextConfig = {
   transpilePackages: ['@workspace/ui', '@workspace/db'],
@@ -11,15 +12,15 @@ const nextConfig = {
     return [
         {
             source: '/admin',
-            destination: `${process.env.ADMIN_DOMAIN}/admin`,
+            destination: `${adminDomain}/admin`,
         },
         {
             source: '/admin/:path+',
-            destination: `${process.env.ADMIN_DOMAIN}/admin/:path+`,
+            destination: `${adminDomain}/admin/:path+`,
         },
         {
             source: '/admin-static/:path+',
-            destination: `${process.env.ADMIN_DOMAIN}/admin-static/:path+`,
+            destination: `${adminDomain}/admin-static/:path+`,
         }
     ];
 }

packages/db/index.ts

@@ -1,6 +1,12 @@
 import { drizzle } from 'drizzle-orm/neon-http';
 import * as schema from './schema.ts';
 
-export const db = drizzle(process.env.DATABASE_URL!, { schema });
+const databaseUrl = process.env.DATABSE_URL;
 
-export * from './schema.ts';
+if(!databaseUrl) {
+    throw new Error{
+        "DTABASE_URL is missing. Create the required env file (see .env.example) and set DATABASE_URL"
+    };
+}
+
+export const db = drizzle(databaseUrl, { schema });