A curated, high-performance web directory of verified free tools, open-source software, streaming platforms, AI utilities, and internet privacy resources.
freeebies.site • Submit a Resource • Contribute via GitHub • Explore Directory
- Modern Tech Stack: Next.js 15 (App Router), React 19, Tailwind CSS, Lucide Icons.
- Robust Persistence: MySQL / MariaDB via Sequelize ORM with local SQLite support for rapid offline development.
- Real-Time Synchronization: Live WebSockets (Socket.IO) updating client cards, voting counters, and admin metrics in real time.
- Hybrid Submission Pipeline:
- Users can submit links via the public Contribute Portal or by submitting Pull Requests to repository Markdown files (
data/*.md). - Submissions approved in the Admin Panel automatically append new rows to their respective Markdown files (
data/<category>.md) to keep the Git history and database 100% congruent.
- Users can submit links via the public Contribute Portal or by submitting Pull Requests to repository Markdown files (
- Enterprise Security & Production Deployment:
- Protected by Cloudflare SSL, HTTP-Only SameSite strict cookies, brute-force rate limiters, and CSRF origin guards.
- Automated Continuous Deployment pipeline running via GitHub Actions directly to production with PM2 cluster reload.
Freebies/
├── app/ # Next.js App Router root
│ ├── admin/ # Admin control center
│ │ ├── categories/ # Category & subcategory manager + Markdown sync editor
│ │ ├── comments/ # Moderation queue for discussions & team notes
│ │ ├── resources/ # Dynamic catalog manager, star pinning & voting
│ │ ├── settings/ # Security hardening metrics, audit logs & change password
│ │ ├── submissions/ # Hybrid queue: UI & GitHub PR approvals
│ │ └── votes/ # IP audit log & vote fraud prevention
│ ├── api/ # REST endpoints & Socket.IO handlers
│ ├── category/ # Dynamic category & subcategory listing pages
│ ├── resource/ # Dynamic detail pages (/resource/[resourceId])
│ ├── contribute/ # Public community submission portal
│ ├── explore/ # Full-text searchable index & tag filter
│ └── layout.tsx # Root layout with SEO metadata & theme providers
├── components/ # Reusable React UI components
│ ├── admin/ConfirmDialog.tsx # Styled modern modal dialogs (no window.confirm)
│ ├── CategoryContentClient.tsx # Dynamic category pills with mouse-wheel scroll
│ ├── CategoryNav.tsx # Horizontal scroll category nav tabs
│ ├── ExploreClient.tsx # Real-time search & interactive directory filters
│ ├── Header.tsx # Responsive header with discreet admin indicator
│ └── LinkCard.tsx # Verified directory link card with ratings & tags
├── data/ # Master Markdown files & category manifests
│ ├── categories.json # Category hierarchy and subcategory tree
│ ├── streaming.md # HD Movies, TV shows & anime tables
│ ├── adblocking.md # Content blockers, DNS filters & VPNs
│ ├── software.md # Free & open-source software (FOSS)
│ └── ai-tools.md # Free LLMs, local runners (Ollama, LM Studio)
├── db/ # Sequelize ORM & MySQL database models
│ ├── models/ # Resource, Submission, Comment, Vote, User, AuditLog
│ ├── connection.ts # Connection pooling & dialect setup
│ └── syncResources.ts # Safe zero-data-loss database sync script
├── deploy/ # Production deployment configuration
│ └── ecosystem.config.cjs # PM2 cluster configuration
└── .github/workflows/ # Continuous Deployment workflows
└── deploy.yml # Automated zero-downtime production deployment
- Node.js: v22 LTS or higher
- pnpm: v9 or v11 (
npm i -g pnpm) - MySQL / MariaDB: MySQL 8.0+ or local SQLite fallback
git clone https://github.com/steveyout/Freebies.git
cd Freebiespnpm installCopy .env.example to .env:
cp .env.example .envSet your configuration:
PORT=3000
NEXT_PUBLIC_SITE_URL=http://localhost:3000
JWT_SECRET=your_super_secret_jwt_key
DB_HOST=127.0.0.1
DB_PORT=3306
DB_NAME=freebies_directory
DB_USER=root
DB_PASSWORD=your_mysql_passwordpnpm run seedpnpm run devOpen http://localhost:3000 in your browser.
We welcome all community contributions! There are two ways to submit new tools, open-source apps, or media sites:
- Visit https://freeebies.site/contribute.
- Enter the resource title, target URL, description, category, and safety attributes.
- Submit! Your submission will enter the admin queue for immediate review and publication.
- Fork this repository.
- Edit the corresponding file in
data/<category>.md(e.g.data/streaming.mdordata/ai-tools.md). - Add a new row to the Markdown table following this standard format:
| **Tool Name** | [toolurl.com](https://toolurl.com) | Quality / Type | Registration | Short description of key features |- Open a Pull Request titled
feat: add <Tool Name> to <Category>. - Once merged, the GitHub Actions deployment pipeline will automatically ingest your changes into the live database!
The administration dashboard is protected by JWT authentication, bcrypt password hashing, sliding-window rate limiters, and CSRF protection.
- URL:
/admin - Features:
- Submissions Queue: Review pending submissions with 1-click approval or custom styled rejection modal. Supports bulk actions (Bulk Approve & Bulk Reject).
- Categories & Markdown Sync: Create/delete categories, add subcategories, and edit
data/*.mdfiles with in-browser syntax highlighting and live database sync. - Dynamic Resources: 1-click star toggle for top priority pinning, full metadata editor, and bulk delete with vote cleanup.
- Comment Moderation: Moderate community discussion threads and private team feedback notes.
- Security & Settings: Change administrator password with real-time strength validation, inspect brute-force rate limit status, and monitor security audit logs.
Distributed under the MIT License. See LICENSE for more information.