Coding mostly in the Local (map) half of our platform to help our members meet each other irl and create local kindness events and projects where they live, or for people who are homeless to help/be helped, or to fight climate change together… or any other community of our connection projects. Tools: Getting started Guide - Join the Team - Goals and Roadmap - Documentation - GitHub
Getting Started Guide
Welcome! This is the getting started guide for the React Js and Meteor Team at The Public Happiness Movement. Posted below is a getting started guide and the main resources we are currently using.
There’s a lot going on here so I recommend reading this post then diving right in by grabbing a task on the tasks board and making something happen, rather than getting overwhelmed trying to understand everything right away. The community members that stick around are always the one’s who dive in right away.
Note: Check and edit your user settings by clicking your icon in the top right. Some new members weren’t receiving notifications, there may be a hidden setting. Its also good to choose how often, and how you are notified.
You’ll need to DM your email one of the admins in this Team and request they add you to our Github Team. For now @AndyatFocallocal is probably the safest bet. p.s. Please do ‘star’ our project on Github to help attract more devs to join the build.
Design Goals
This platform is designed to create pro-active incentivised online and in-person communities focused on a shared interest topic. Communities where everyone actively participates in building, growing and making decisions to achieve a shared mission statement, guided by a community values statement.
You can read more about the Design Principles here
App
Here’s the Android App for Meta. It does make communications easier and more fluid. The iOS version is coming soon.
Current platforms:
- Public Happiness Movement (Meta): Uniting communities locally and globally to take action and build a world with more peace and well-being in. Find people nearby to meet for fun science backed activities which target societal issues through positive action, and build global projects which tackle worldwide issues by empowering local communities
- Brighter Tomorrow Map: Bringing communities together to provide support to people who are in need of support nearby. Focused on homelessness and disaster relief.
Upcoming:
- Community Climate Action platform
- House of Wiggles
Documentation
You’ll find all our packages, dependencies, etc detailed here. If you’re doing a task and can’t find a suitable guide in the documentation please write one as you go which will help the next person pick up exactly where you left off if they come to make an edit or update in the future.
Introductions
Come and say hi and tell people a bit about yourself and why you want to join us on this mission for a happier, kinder world. Don’t forget to follow the thread and say hi and make new members feel welcome. Their skills and enthusiasm brings all of our dreams closer.
Join the Team
Joining the team means other members can reach out to you when they want feedback on their work and suggestions, or to ask if anyone can help with a React or Meteor related task. Its your choice if you want to be part of the team, or contribute in a less involved way. You will receive more notifications and have more say in how the site grows.
Current Team Tasks
To find, discuss and post specific tasks click the ‘Tasks’ tab of the Reactjs or Meteor tag.
These should be broken into self-contained actionable slices of 30mins to 1hr so people from around the world can contribute in bite-sized time contributions, rather than excluding those who aren’t able to commit large amount of time. They can be strung together, just move them all over and assign to yourself if you plan to tackle them in one sitting.
Please try to keep to this rule when posting tasks. If the tasks are large and can’t be self contained, then use add [Discussion] at the beginning of the title, and add tags for all the groups needed to break it up into self-contained tasks.
note: some users are seeing this tab called ‘Board’. Its a bizarre bug we’re working to solve
Setting up a Local ReactJS Dev Environment
The guide linked should be pretty complete, but there are many helpful people here to help if you run into bugs. This guide only sets up the React (Local) side and some functionality won’t work in your environment, most noticeably buttons and links will need to be typed manually.
- Setting up a full version in Localhost takes a bit longer. If you want to set up the full platform here’s a full walkthrough: Complete Walkthrough - Setting up an instance of our platform
Navigating the ReactJS and Meteor App without setting up Discourse.
The React and Meteor app loads here:
- https://fl-maps.publichappinessmovement.com/map (if for any reason you want to access the other platforms standalone app you’d go to https://fl-maps.[their url].com
The nav menu there is legacy from our old platform and contains some fun easter eggs, but is no use for navigating the app. You can find all the relative paths needed for navigation, and their live site pairs here:
How to Suggest a Change to the Platform
Simply create a post and tag it ‘Reactjs’, ‘Web-Dev’ and ‘Backlog’. It’ll now appear as a task for both the Dev and React Teams to be discussed by others, and implemented by those with the required skills.
Generally you’ll be adding the ‘backlog’ tag for new ideas. If you deem it an urgent change you can use the ‘sprint’ tag. If work has already begun you’d use the ‘doing’ tag.
Collaborating with other Teams
You may also want to involve other teams to help solve the task by adding their tag. For example: ‘UI’, ‘Graphic-Design’, ‘Copy-Writing’, ‘UX’.
If you need support from another team then your suggestion is probably not ready to be posted as a self contained ‘task’, so consider tagging it as a discussion and adding [Discussion] to the beginning of the title.
Its also often a good idea to tag their team in the post to get more eyes on it using the @ key
Coding and Committing
Visit the Making a PR or Commit guide
Seeking Paid Work
We run r/webdevjobs on Reddit to help team members who are looking for jobs. Each month we’ll pin a post of the profile of all the active members here who are looking for web dev related jobs so you get more offers.
Just fill in this Wizard and we’ll post your profile in the monthly pinned post.
Learning
This community is a great place for learning a new skill. Just search for the learning tag combined with any skill you’d like to learn to see if others have posted free courses, and are learning that skill here too. The benefits of learning here are:
- Crowd sourced learning resources
- Others to learn with
- Experienced professionals who want to support, mentor and offer guidance to those earlier on the same path
- Free or discounted courses to get qualifications
- Learn your skill by contributing to building projects in the real world
- Tasks posted suitable for beginners, and with experienced industry professionals you can call with an @ command to check your work and give feedback/support
- Tasks are public. Future employers can check what tasks you’ve done, follow how your skill advanced, see which projects you’ve built, and how you communicate with a team.
1st one there in this team? Post in forums and bring others over. There’ll be no shortage of people who want to learn while building positive projects which create a kinder, happier world.
Resources
**If you cannot access any of the below resources, please contact @AndyatFocallocal.
Most up-to-date links to project resources:
- How to Post Correctly in this Forum
- Google drive folder
- Documentation Category (or use tags to search)
- Request Access to settings.json
Tools
- Threads created in this forum to discuss ideas and plan with each other
- Tasks in the Team’s Tag for project management. Add the tag ‘Backlog’ to create a card for a non-urgent tasks. Sprint is for priority tasks aimed to be completed this month (impact / time to implement). Please assign cards to yourself and move them into the ‘Doing’, then ‘Done’ lists. Click ‘tasks’ or visit this link to access
- Documentation use our tag combined with the ‘documentation’ tag
- Team Calendar Its common to put volunteer commitments off, and many community members found the most helpful thing they could do is to have a monthly or weekly reminder to schedule your intended time to work by adding it to your team calendar. More details here
There is a supplementary Slack channel linked to the General thread in this sub-category, for those who have a specific need to use Slack rather than this forum at times. The Slack channel is here #meteor-react-build. It is a backup rather than primary discussion space as not everyone will see discussions going on over there. If they are important someone should transfer them here when possible.
Please move all actionable ideas out of discussions on the forum and create cards for them. They will get buried and lost if left in this forum. Cards are ordered with the ones to be completed next at the top of a list, and can be claimed or assigned. Users do not have to follow this strictly, its just to aid prioritisation. Ideally each card should take 30mins - 1hr to complete. If longer please try to break it up.
Other Rewards
Its definitely best to join in because you want to see the changes it can bring to the world, and be part of a fun, positive and pro-active community.
We also invite anyone who plays a significant role into our team page, and are enthusiastic to support you if it helps your resume building: Public Happiness
Everyone who completes any tasks will be rewarded with Public Happiness Tokens at launch. We don’t guarantee they’ll ever be worth anything, tbh they are an experimental tool to add more fuel to drive the vision. I’m increasingly confident though.
Who’s the Boss?
Well for now anyway. Andy is me and i can also be seen as the biggest limiting factor on our productive capacity. I do my best to represent the founding vision, and the work and decisions of all community members who are not currently active, preventing a situation where everyone joining in throws out the work of others and starts over.
The more decisions you take for yourself the better. I am there to guide until teams grow to be autonomous. Run ideas by me to begin with, until there are enough active and experienced members here to switch to the voting system. Your goal is to make this your space.
We have a Roadmap which will lead to a reputation-based decentralised governance system where you, and all community members are the boss, with votes weighted by how much they’ve contributed to the vision.
The Roadmap for transition is:
- Run ideas by Andy
- As team members understanding of the concept we are building, and vision grows we move to a leadership council made up of those who’ve contributed the most the vision
- Arriving at a reputation based decentralised governance system.
You can read more about governance in chapter 6.11 in the whitepaper
The real answer is: You are the boss, as soon as you are ready.
Notes
-
You may find some references or links to focallocal.org and Trello. We are not using these anymore so please report them to a moderator to be updated. The site name PublicHappinessMovement.com may be changed before launch as it’s not perfect either.
-
A more detailed plan of building our eco-system and vision for a world with more attention to peace, well-being and happiness, is here in the Whitepaper. Be warned it is a very long read
-
Please ‘star’ our project on GitHub to help attract more team members to the build