Data

Tools

Indexes

Applications

Experiments

Awesome

An open API service indexing awesome lists of open source software.

https://github.com/piotrkulpinski/openalternative

A community driven list of open source alternatives to proprietary software and applications.
https://github.com/piotrkulpinski/openalternative

alternatives aws-s3 better-auth coss cron foss inngest nextjs nextjs15 open-source oss postgresql stripe vercel

Last synced: 16 days ago
JSON representation

A community driven list of open source alternatives to proprietary software and applications.

Awesome Lists containing this project

README 

          
![OpenAlternative](https://openalternative.co/opengraph.png)








  Discover open source alternatives to popular software.

  


  Learn more »

  


  


  Website

  ·

  Issues






   Github Stars

   Better Stack

   License

   Commits-per-month

   

   open in devcontainer

   

   Hacker News






  OpenAlternative - Discover open source alternatives to popular software | Product Hunt

  OpenAlternative - Discover open source alternatives to popular software | Product Hunt




## About this project



OpenAlternative is a community driven list of **open source alternatives to proprietary software** and applications.



Our goal is to be your first stop when researching for a new open source service to help you grow your business. We will help you **find alternatives** of the products you already use.



Join us in creating the biggest **directory of open source software**.



## Other projects



We are also working on other projects you might be interested in:



- [EuroAlternative](https://euroalternative.co) - A directory of European alternatives to Big Tech giants.

- [DevSuite](https://devsuite.co) - A collection of tools for developers.

- [Dirstarter](https://dirstarter.com) - A Next.js boilerplate for creating directory websites.



## Sponsoring



OpenAlternative is an GPL-3.0-licensed open source project with its ongoing development made possible entirely by the support of these awesome backers. If you'd like to join them, please consider [sponsoring OpenAlternative's development](https://github.com/sponsors/piotrkulpinski).



If you'd like to support the project, you could also consider [buying our Next.js boilerplate](https://dirstarter.com) which is the foundation of creating directory websites, just like this one.



## Services



OpenAlternative uses the following third-party services:



- Database: [Neon](https://neon.tech)

- Analytics: [Plausible](https://plausible.io), [PostHog](https://posthog.com)

- Newsletter: [Beehiiv](https://go.openalternative.co/beehiiv)

- Scraping: [Firecrawl](https://go.openalternative.co/firecrawl)

- Background Jobs: [Inngest](https://inngest.com)

- File Storage: [AWS S3](https://aws.amazon.com/s3)

- Payments: [Stripe](https://stripe.com)

- Screenshots: [ScreenshotOne](https://go.openalternative.co/screenshotone)



Make sure to set up accounts with these services and add the necessary environment variables to your `.env` file.



## Project Structure



OpenAlternative is built in Next.js App Router. The project structure is organized as follows:



- `/app` - Application routes and layouts (Next.js App Router)

- `/components` - Reusable React components

- `/lib` - Core utilities and business logic

- `/actions` - Server actions

- `/utils` - Helper functions and utilities

- `/hooks` - React hooks

- `/contexts` - React context providers

- `/services` - Service integrations

- `/emails` - Email templates

- `/server` - Server-side code

- `/functions` - Utility functions

- `/config` - Configuration files

- `/content` - Content management

- `/prisma` - Prisma schema and utilities

- `/types` - TypeScript type definitions

- `/public` - Static assets



## Development



This project uses [Bun](https://bun.sh/) as the package manager and runtime. Make sure you have Bun installed before proceeding.



To set up the project for development:



1. Clone the repository

2. Run `bun install` to install all dependencies

3. Set up the required environment variables (see below)

4. Run `bun run db:push` to push the Prisma schema to the database

5. Run `bun run dev` to start the application in development mode



### Environment Variables



Refer to the `.env.example` file for a complete list of required variables.



Copy the `.env.example` file to `.env` and update the variables as needed:



```bash

cp .env.example .env

```



## 🧞 Commands



All commands are run from the root of the project, from a terminal:



| Command           | Action                                           |

| :---------------- | :----------------------------------------------- |

| `bun install`     | Installs dependencies                            |

| `bun run dev`     | Starts local dev server at `localhost:5173`      |

| `bun run build`   | Build production application                     |

| `bun run start`   | Preview production build locally                 |

| `bun run lint`    | Run linter                                       |

| `bun run format`  | Format code                                      |

| `bun run typecheck` | Run TypeScript type checking                   |

| `bun run db:generate` | Generate Prisma client                       |

| `bun run db:studio` | Start Prisma Studio                           |

| `bun run db:push` | Push Prisma schema to database                  |

| `bun run db:pull` | Pull Prisma schema from database                |

| `bun run db:reset` | Reset Prisma schema                            |



## Deployment



The project is set up for deployment on Vercel. To deploy manually:



1. Build the project: `bun run build`

2. Start the production server: `bun run start`



Ensure all environment variables are properly set in your production environment.



## License



OpenAlternative is licensed under the [GPL-3.0 License](LICENSE).