Skip to content

AC-VIII/shit-app

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
 
 
 
 
 
 

Repository files navigation

💩 shit-app

Stability Maintained AI Production Ready Bugs

the open-source project equivalent of "it works on my machine"


🚀 What is this?

shit-app is a completely unnecessary public app where people can add literally whatever they want.

No roadmap.
No architecture.
No standards.
Only chaos.

This repository exists for:

  • random experiments
  • cursed ideas
  • funny pull requests
  • terrible UX decisions
  • accidental innovation
  • emotional damage from merge conflicts

🔥 Features

Current features include:

  • absolutely nothing
  • emotional instability
  • questionable code quality
  • future bugs
  • potential browser destruction

Planned features:

  • useless dark mode
  • fake AI assistant
  • button that runs away from your cursor
  • infinite loading screen
  • enterprise edition nobody asked for
  • quantum CSS
  • 3D spinning potato
  • bug leaderboard
  • fake crypto integration
  • loading simulator simulator

🛠️ Installation

Clone this masterpiece:

git clone https://github.com/yourusername/shit-app.git

Enter the danger zone:

cd shit-app

Install dependencies that may or may not matter:

npm install

Run the app:

npm run dev

If it works first try, something is wrong.


🤝 Contributing

Contributions are encouraged.

This is a safe place for:

  • bad ideas
  • overengineering
  • underengineering
  • cursed CSS
  • pointless APIs
  • accidental features

How to contribute

  1. Fork the repo
  2. Add something questionable
  3. Commit with a terrible message
  4. Open a PR
  5. Wait for chaos

Contribution ideas

  • add a useless setting
  • make the UI worse
  • add dramatic sound effects
  • create fake settings
  • add random error messages
  • add a button that apologizes
  • add unnecessary animations
  • make a feature only work on Firefox from 2017
  • create a page that says "coming soon" forever

🤖 AI / LLM RULES

NO AI CHEATING.

This repository supports authentic developer suffering.

If you contribute:

  • write the code yourself
  • debug your own disasters
  • suffer naturally
  • question your decisions manually

DO NOT:

  • paste AI-generated spaghetti code
  • generate entire features using ChatGPT
  • pretend your LLM-generated code is handcrafted art
  • automate the chaos

We want:

  • real frustration
  • real bugs
  • real confusion
  • human-made terrible decisions

If your feature was built during a mental breakdown at 2AM, it belongs here.


📜 Rules

Very important rules for a very serious project:

  1. don't intentionally harm users
  2. don't upload malware
  3. don't delete the repository
  4. keep the chaos funny
  5. if the feature is stupid but entertaining, merge it
  6. terrible commit messages are encouraged
  7. nobody fully understands the codebase
  8. documentation should increase confusion slightly

💀 Recommended Commit Messages

git commit -m "fixed stuff"
git commit -m "idk bro"
git commit -m "this seemed funny at 2am"
git commit -m "made things worse somehow"
git commit -m "README became sentient"
git commit -m "probably production ready"
git commit -m "human written bugs included"
git commit -m "webpack attacked me first"
git commit -m "no AI only pain"
git commit -m "who approved this"

🧠 Philosophy

Modern software is too polished.

Too optimized.
Too professional.
Too stable.

shit-app exists to fight back.

We believe:

  • confusion builds character
  • random ideas deserve deployment
  • unnecessary animations improve morale
  • debugging is a personality trait
  • perfection is overrated

This project is powered by:

  • poor decisions
  • sleep deprivation
  • internet chaos
  • caffeine
  • ignored warnings

🌍 How To Make This Repo Worse (Or Better)

Help this repository spread across the internet:

  • star the repo
  • create cursed pull requests
  • share screenshots online
  • confuse recruiters with it
  • add features nobody requested
  • submit issues describing emotional damage

Bonus points if:

  • your feature crashes Safari
  • your code scares senior engineers
  • your CSS violates human rights

🐛 Known Bugs

  • yes

⚠️ Disclaimer

The maintainers are NOT responsible for:

  • broken laptops
  • corrupted stylesheets
  • browser crashes
  • emotional damage
  • lost sleep
  • debugging nightmares
  • existential crises
  • spontaneous overengineering

Use at your own risk.


🧃 Final Notes

This project may someday become:

  • a real app
  • a complete disaster
  • both simultaneously

Thank you for visiting shit-app.

Now go add something terrible.

Releases

No releases published

Packages

 
 
 

Contributors

Languages