Discover open source alternatives to popular software.
Learn more »

Website · Issues

About this project

m4v 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.

Sponsoring

m4v 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 m4v’s development.

If you’d like to support the project, you could also consider buying our Next.js boilerplate which is the foundation of creating directory websites, just like this one.

Services

m4v uses the following third-party services:

• Database: Neon
• Analytics: Plausible, PostHog
• Newsletter: Beehiiv
• Background Jobs: Inngest
• File Storage: AWS S3
• Payments: Stripe
• Screenshots: ScreenshotOne

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

Project Structure

m4v is built as a Turborepo monorepo with multiple packages. The project structure is organized as follows:

• /apps - Turborepo apps

  • /app - Main Next.js application using the App Router architecture

    • /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
    • /types - TypeScript type definitions
    • /public - Static assets

  • /analyzer - Data analysis tools

• /packages - Shared packages

  • /db - Database schema and utilities
  • /github - GitHub integration utilities

The project uses Turborepo for task orchestration and dependency management across the monorepo.

Development

This project uses Bun 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:

cp .env.example .env

🧞 Commands

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

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

m4v is licensed under the GPL-3.0 License.