DEV Community 👩💻👨💻The Human Layer of the Stack
<p align=“center”> <a href=“www.ruby-lang.org/en/”> <img src=“img.shields.io/badge/Ruby-v2.6.5-green.svg” alt=“ruby version”> </a> <a href=“rubyonrails.org/”> <img src=“img.shields.io/badge/Rails-v5.2.3-brightgreen.svg” alt=“rails version”> </a> <a href=“travis-ci.com/thepracticaldev/dev.to”> <img src=“travis-ci.com/thepracticaldev/dev.to.svg?branch=master” alt=“Travis Status for thepracticaldev/dev.to”> </a> <a href=“codeclimate.com/github/thepracticaldev/dev.to/maintainability”> <img src=“api.codeclimate.com/v1/badges/ce45bf63293073364bcb/maintainability” alt=“Code Climate maintainability”> </a> <a href=“codeclimate.com/github/thepracticaldev/dev.to/test_coverage”> <img src=“api.codeclimate.com/v1/badges/ce45bf63293073364bcb/test_coverage” alt=“Code Climate test coverage”> </a> <a href=“oss.skylight.io/app/applications/K9H5IV3RqKGu”> <img src=“badges.skylight.io/status/K9H5IV3RqKGu.svg?token=Ofd-9PTSyus3BqEZZZbM1cWKJ94nHWaPiTphGsWJMAY” alt=“Skylight badge”> </a> <a href=“www.codetriage.com/thepracticaldev/dev.to”> <img src=“www.codetriage.com/thepracticaldev/dev.to/badges/users.svg” alt=“CodeTriage badge”> </a> <img src=“flat.badgen.net/dependabot/thepracticaldev/dev.to?icon=dependabot” alt=“Dependabot Badge” /> </p>
Welcome to the dev.to codebase. We are so excited to have you. With your help, we can build out DEV to be more stable and better serve our community.
What is dev.to?
dev.to (or just DEV) is a platform where software developers write articles, take part in discussions, and build their professional profiles. We value supportive and constructive dialogue in the pursuit of great code and career growth for all members. The ecosystem spans from beginner to advanced developers, and all are welcome to find their place within our community. ❤️
Table of Contents
We encourage you to contribute to dev.to! Please check out the Contributing to dev.to guide for guidelines about how to proceed.
Additional technologies and services are listed on our docs.
This section provides a high-level requirement & quick start guide. For detailed installations, such as getting started with GitPod, Docker, or specific operating systems, please check out our docs.
PostgreSQL 9.4 or higher.
Make sure all the prerequisites are installed.
Fork dev.to repository, ie. github.com/thepracticaldev/dev.to/fork
Clone your forked repository, ie.
git clone https://github.com/
Set up your environment variables/secrets
Take a look at
Envfile. This file lists all the
ENVvariables we use and provides a fake default for any missing keys. You'll need to get your own free Algolia credentials to get your development environment running. You can add these to your
config/application.ymlfile using the process described below.
This guide will show you how to get free API keys for additional services that may be required to run certain parts of the app.
For any key that you wish to enter/replace:
config/application.ymlby copying from the provided template (ie. with bash:
cp config/sample_application.yml config/application.yml). This is a personal file that is ignored in git.
Obtain the development variable and apply the key you wish to enter/replace. ie:
GITHUB_KEY: "SOME_REAL_SECURE_KEY_HERE" GITHUB_SECRET: "ANOTHER_REAL_SECURE_KEY_HERE"
If you are missing
ENVvariables on bootup,
enviedgem will alert you with messages similar to
'error_on_missing_variables!': The following environment variables should be set: A_MISSING_KEY..
You do not need "real" keys for basic development. Some features require certain keys, so you may be able to add them as you go.
That's it! Run
bin/startupto start the application and head to
Docker Installation (BETA)
Please refer to the Installing DEV with Docker [Beta] guide.
Starting the application
We're mostly a Rails app, with a bit of Webpack sprinkled in. For most cases, simply running
bin/rails server will do. If you're working with Webpack though, you'll need to run the following:
bin/startupto start the server, Webpack, and our job runner
foreman start -f Procfile.devunder the hood.
alias start="bin/startup"makes this even faster. 😊
If you're using
pryfor debugging in Rails, note that using
prytogether works, but it's not as clean as
Here are some singleton commands you may need, usually in a separate instance/tab of your shell.
Running the job server (if using
bin/rails server) – this is mostly for notifications and emails:
Clearing jobs (in case you don't want to wait for the backlog of jobs):
Current gotchas: potential environment issues with external services need to be worked out.
We use Spring, and it is already included in the project.
Use the provided bin stubs to start Spring automatically, i.e.
If Spring isn't picking up on new changes, use
spring stop. For example, Spring should always be restarted if there's a change in environment key.
Check Spring's status whenever with
bin/rspec is not equipped with Spring because it affects Simplecov's result. Instead, use
We welcome security research on DEV under the terms of our vulnerability disclosure policy.
This program is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. Please see the LICENSE file in our repository for the full text.
Like many open source projects, we require that contributors provide us with a Contributor License Agreement (CLA). By submitting code to the DEV project, you are granting us a right to use that code under the terms of the CLA.
Our version of the CLA was adapted from the Microsoft Contributor License Agreement, which they generously made available to the public domain under Creative Commons CC0 1.0 Universal.
Any questions, please refer to our license FAQ doc or email firstname.lastname@example.org
Happy Coding ❤️