Skip to content

About

A simple website to showcase your project to the world.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

Project Discovery

A simple place to showcase your project to the world.

What is this?

Project Discovery is a website where you can publish and showcase your projects, whether it's a website, SaaS, mobile app, service, or whatever you've been building.

I made it in my free time, simple and straight to the point.

Why open source?

Because I know it's missing a bunch of features. Instead of keeping it to myself until it's "perfect", I'd rather share it so anyone who wants to can contribute and make it better.

Tech Stack

  • PHP - Pure and simple
  • Composer - For handling dependencies (phpdotenv, JWT)
  • HTML/CSS/JS - No heavy frameworks, just what's needed, back to the basics.
  • JWT - For authentication

Project Structure

├── components/      # Reusable components (navbar, etc)
├── css/            # Styles per page
├── functions/      # PHP logic (login, register, publish, etc)
├── includes/       # Configuration (auth, database, turnstile)
├── js/             # JavaScript per page
├── templates/      # HTML templates
└── public/         # Public assets

Getting Started

  1. Clone the repo:
git clone https://github.com/yourusername/project-discovery.git
cd project-discovery
  1. Install dependencies:
composer install
  1. Set up your database:

    • Create a new MySQL database
    • Import the schema:
    mysql -u your_username -p your_database < database.sql

    Or use phpMyAdmin/MySQL Workbench to import database.sql

  2. Configure your environment:

    • Copy .env.example to .env:
    cp .env.example .env
    • Edit .env with your actual credentials:
      • Database credentials
      • JWT secret (generate a random string)
      • Your app URL
      • Cloudflare Turnstile key (optional, for captcha)
  3. Done! Fire up your local server and you're good to go

What's missing?

A lot of things, honestly:

  • Better search system
  • Reset password feature
  • Categories and filters
  • Comment system
  • Likes/favorites
  • More complete user profile
  • And probably a bunch more I can't think of right now

Want to Contribute?

That would be awesome! No complicated rules:

  1. Fork the project
  2. Create a branch for your feature (git checkout -b feature/something-cool)
  3. Make your changes
  4. Commit (git commit -m 'Added something cool')
  5. Push (git push origin feature/something-cool)
  6. Open a Pull Request

If you're not sure about something, just open an issue and we'll talk about it.

Final Note

This project isn't perfect, nor does it pretend to be. It's functional, it's lightweight, and it covers the basics.

If it works for you, great. If you want to make it better, even better.


Made with ☕ in my free time.

About

A simple website to showcase your project to the world.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages