Project creation walkthrough
Last updated
Was this helpful?
Last updated
Was this helpful?
: We have an on the Code for Philly leadership team.
Before starting a project, make sure that you have a Code for Philly account and have joined our (shown in screencast below).
There are four steps to creating a project.
For the public good.
Open source and available to the public.
Not political or partisan.
These are guidelines, and not rules. Code for Philly leadership is happy discuss project ideas that may seem like they fall outside the guidelines.
This document asks about who your project is for, its goals, and any delivery dates you are working toward. It helps us share and discuss the project within Code for Philly leadership.
Here, you can enter the title of your project and name of your soon-to-be slack channel. In general, it's helpful to name your slack channel something similar to your project title. For example, if your project is named My Civic Project, a good slack channel might be my-civic-project.
The description you enter should be enough for volunteers to answer:
Who is this for?
What are its goals?
What roles are needed (e.g. frontend engineer, or UX person)
It's okay to start a Code for Philly project while you're still in the ideation / planning phase. Once you draw closer to implementation, be sure to add a plan with a roadmap and/or timeline to your project. This helps recruit more volunteers to your project, by showing them there is implementation work to do.
There are several ways to increase engagement with your project, and get things moving towards the project's goals. When Code for Philly leadership have capacity, we can events like...
Guiding volunteers to your project. If you keep activity in your project's slack channel, it helps us follow along with how things going, and point new volunteers to your project.
Even without leadership involvement, there are many ways to recruit and organize volunteers at Code for Philly, including...
Attending hack nights (or having weekly online project meetings)
Contributing to other Code for Philly projects, to get a sense for how projects can be organized.
- read our to ensure it meets our criteria.
- fill out the intake questionnaire, then create a project page and slack channel.
- list a small roadmap on your project page.
- schedule a hacknight for presenting.
Broadly, our ask projects to meet four criteria:
Adhere to our
Create a copy of the (shown below), and fill it out.
If you'd rather it not be publicly available, please email it to leadership@codeforphilly.org. Otherwise, share it on the .
First, go to the , and "add project" (shown below).Here, you can enter the title of your project, and name of your projects soon-to-be slack channel.
At the very bottom of the page, you'll add a description of your project. The description can be formatted using .
See these the , , and projects for examples.
Sign on to the . Pull up the create channel form and enter your channel name (shown below). The channel name should be the same as the one you entered when you created the project page (in the field "Chat channel/hashtag").
A project update is shown on the Code for Philly homepage. For an example, see this .
Hack night presentations. Hack night is an event that occurs several times a month. See our for upcoming hack nights. Please reach out to Code for Philly leadership if you are interested in presenting at a hack night. If there are no hack nights scheduled, and we have capacity, we can work on creating an event.
Posting in the slack channel