oss.now

A platform for open source project discovery, collaboration, and growth

Connecting project owners with contributors

---

🚀 About

oss.now is a modern platform designed to bridge the gap between open source project maintainers and contributors. Whether you're looking to showcase your project, find contributors with specific skills, or discover exciting projects to contribute to, oss.now provides the tools and community to make it happen.

Key Features

• Project Discovery - Browse and filter open source projects by category, technology, and activity
• GitHub & GitLab Integration - Seamlessly connect your repositories and showcase real-time stats
• Project Launches - Announce major releases and updates to the community
• Early Submissions - Submit your project early for increased visibility
• Contributor Matching - Find contributors with the skills your project needs
• Analytics Dashboard - Track your project's growth and engagement

🛠️ Tech Stack

• Frontend: Next.js 15 (App Router) + React 19 + TypeScript
• Styling: Tailwind CSS + shadcn/ui components
• Backend: tRPC + Node.js
• Database: PostgreSQL (via Neon) + DrizzleORM
• Caching: Redis (Upstash)
• Authentication: Better-Auth with GitHub & GitLab OAuth
• Analytics: Databuddy
• Deployment: Vercel

📁 Project Structure

This is a monorepo managed with Turbo:

ossdotnow/
├── apps/
│   └── web/          # Next.js web application
├── packages/
│   ├── api/          # tRPC API routes
│   ├── auth/         # Authentication logic
│   ├── db/           # Database schema and migrations
│   ├── env/          # Environment variable validation
│   └── ui/           # Shared UI components
└── turbo.json        # Turbo configuration

🚀 Getting Started

Prerequisites

• Bun v1.2.13 or higher
• Docker (for local PostgreSQL and Redis)
• Git

Installation

1. Clone the repository

bash git clone https://github.com/ossdotnow/ossdotnow.git cd ossdotnow

1. Install dependencies

bash bun install

1. Set up environment variables

Make a copy of .env.example and replace values with your own.

1. Start the database services

bash bun docker:up

1. Run database migrations

bash bun db:migrate

1. Seed the database (optional)

bash bun db:seed

1. Start the development server

bash bun dev

The application will be available at http://localhost:3000

📝 Available Scripts

Development

• bun dev - Start the development server with hot reload
• bun build - Build the application for production
• bun start - Start the production server

Database

• bun docker:up - Start PostgreSQL and Redis containers
• bun docker:down - Stop the containers
• bun docker:clean - Stop containers and remove volumes
• bun db:generate - Generate database migrations
• bun db:migrate - Apply database migrations
• bun db:push - Push schema changes directly (development only)
• bun db:studio - Open Drizzle Studio for database management
• bun db:seed - Seed the database with sample data
• bun db:make-all-admin - Grant admin privileges to all users (development only)

Code Quality

• bun lint - Run ESLint
• bun format - Format code with Prettier
• bun typecheck - Run TypeScript type checking

🔐 Setting up OAuth Providers

GitHub OAuth

1. Go to GitHub Developer Settings
2. Click "New OAuth App"
3. Fill in the details:
4. Application name: oss.now (Development)
5. Homepage URL: http://localhost:3000
6. Authorization callback URL: http://localhost:3000/api/auth/callback/github
7. Copy the Client ID and Client Secret to your .env file

GitLab OAuth

1. Go to GitLab Applications
2. Create a new application with the following:
3. Name: oss.now (Development)
4. Redirect URI: http://localhost:3000/api/auth/callback/gitlab
5. Scopes: api, read_api, read_user, read_repository, openid, profile, email
6. Copy the Application ID (Client ID) and Secret to your .env file

🤝 Contributing

We love contributions! Please read our Contributing Guide to learn about our development process, how to propose bug fixes and improvements, and how to build and test your changes.

Development Workflow

1. Fork the repository
2. Create a new branch from dev (not main) bash git checkout -b feature/your-feature-name
3. Make your changes
4. Run tests and ensure code quality bash bun lint bun typecheck
5. Commit your changes with descriptive messages
6. Push to your fork and create a Pull Request

Important Notes

• Always branch off from dev, not main
• Make sure no other Next.js apps are running locally as it may interfere with OAuth flows
• The application is currently in development mode on production to prevent public access

🚀 Deployment

The application is designed to be deployed on Vercel:

1. Fork this repository
2. Import the project in Vercel
3. Configure environment variables in Vercel dashboard
4. Deploy!

For production deployments, ensure you:

• Update OAuth callback URLs to your production domain
• Use production database and Redis instances
• Set VERCEL_ENV=production

📚 Architecture

Frontend

• Next.js 15 with App Router for server-side rendering and routing
• React 19 for UI components
• TanStack Query for data fetching and caching
• Tailwind CSS for styling
• shadcn/ui for consistent UI components

Backend

• tRPC for type-safe API endpoints
• DrizzleORM for database queries and migrations
• Better-Auth for authentication
• Upstash Redis for rate limiting

Database Schema

• Users and authentication tables
• Projects with categories and metadata
• Submissions and waitlist
• Project launches and comments
• Voting and reporting systems

🐛 Troubleshooting

Common Issues

1. OAuth redirect issues

2. Ensure no other Next.js apps are running on port 3000

3. Check that callback URLs match exactly

4. Database connection errors

5. Make sure Docker is running

6. Check that PostgreSQL is accessible on port 5432

7. Verify DATABASE_URL is correct

8. Environment variable errors

9. All required variables must be set
10. Run bun dev to see validation errors

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

• Built with Next.js
• UI components from shadcn/ui
• Database provided and powered by Neon
• Hosting on Vercel

---

Made with ❤️ by the oss.now team