Neocities.org - the web site. Yep, the backend is open source!
  • JavaScript 95.5%
  • CSS 1.9%
  • HTML 1.4%
  • Ruby 1%
  • SCSS 0.2%
Find a file
2026-05-07 13:01:37 -05:00
.github/workflows attempt 1 of several million to fix coveralls 2024-11-19 17:18:21 -06:00
app api/delete strenghening, dashboard multi-select delete, obsolete site_files/delete (use api instead) 2026-05-07 12:32:50 -05:00
ext fix for purge syntax to official spec, purger test 2025-08-09 13:48:19 -05:00
files sitemap: improvements, fixes, add tags 2019-10-09 15:13:42 -07:00
migrations needs_moderation flag 2025-09-23 20:17:04 -05:00
models more eager cache purging - tess for activity/simplecache changes 2026-04-28 10:00:09 -05:00
public wait mode for pending delete 2026-05-07 13:01:37 -05:00
sass wait mode for pending delete 2026-05-07 13:01:37 -05:00
tests wait mode for pending delete 2026-05-07 13:01:37 -05:00
vagrant update vagrantfile to work with latest, closes #478 2024-01-04 02:30:24 -06:00
views wait mode for pending delete 2026-05-07 13:01:37 -05:00
workers more eager cache purging - tess for activity/simplecache changes 2026-04-28 10:00:09 -05:00
.gitignore whitelist emails capability 2024-03-13 16:20:32 -05:00
app.rb enforce csrf for admin routes 2026-04-27 10:44:44 -05:00
app_helpers.rb improve meta desc for pages for search engines 2026-02-10 14:04:09 -06:00
code-of-conduct.txt Update code-of-conduct.txt 2016-02-08 12:45:41 -08:00
config.ru site object local instead of instance, prevents crossover in future multithreading 2026-04-27 10:54:40 -05:00
config.yml.ci admin: blur moderation for certain categories 2026-03-25 19:23:57 -05:00
config.yml.template admin: blur moderation for certain categories 2026-03-25 19:23:57 -05:00
environment.rb a few missing values for site info 2025-12-18 15:43:29 -06:00
Gemfile fix btc validator for tips 2026-01-02 11:50:26 -06:00
Gemfile.lock Merge pull request #635 from neocities/dependabot/bundler/addressable-2.9.0 2026-04-09 11:06:58 -05:00
LICENSE.txt Add BSD 2-clause license 2013-06-22 18:59:38 -07:00
puma_config.rb use etc to set processor count 2025-12-31 12:21:59 -06:00
rainbows_config.rb mostly finished port to ruby3 2022-08-10 14:31:36 -05:00
Rakefile change robots.txt to help enforce boundary between root and subdomains 2025-08-13 11:41:57 -05:00
README.md Update the README 2024-08-15 19:08:38 +01:00
Vagrantfile update vagrantfile to work with latest, closes #478 2024-01-04 02:30:24 -06:00

Neocities.org

Build Status Coverage Status

The web site for Neocities! It's open source. Want a feature on the site? Send a pull request!

Getting Started

Neocities can be quickly launched in development mode with Vagrant. Vagrant builds a virtual machine that automatically installs everything you need to run Neocities as a developer. Install Vagrant, then from the command line:

vagrant up --provision

Vagrant takes a while, make a pizza while waiting

Make a copy of config.yml.template in the root directory, and rename it to config.yml. Then:

vagrant ssh
bundle exec rackup -o 0.0.0.0

Now you can access the running site from your browser: http://127.0.0.1:9292

Want to contribute?

If you'd like to fix a bug, or make an improvement, or add a new feature, it's easy! Just send us a Pull Request.

  1. Fork it (https://github.com/neocities/neocities/fork)
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create new Pull Request