The MarsBased Handbook

Welcome to MarsBased! This is the first thing you should read when boarding the MarsBased spaceship.

MarsBased is an all-remote development consultancy from Barcelona, pioneering AI-augmented development and leveraging advanced tools like Claude Code. We build web and mobile products using Ruby on Rails, Python and JavaScript, working at the intersection of business and technology. Driven by our Research, Plan, and Implement methodology, we help companies bring their innovation projects to life with maximum efficiency and precision.

Here you will find the most important information about the company to help you to get familiar with it. We also compiled some of our guides & interesting stuff you should read (and some trivia & fun stories to make it more digestible).

If you’re a visitor and want to use them, feel free to use them anywhere, but we’d appreciate it that you linked us back in appreciation.

We have decided to make this handbook publicly available so we can share as much as we can with other companies out there, potential candidates and prospective clients alike. Everyone is welcome!

Sections

1. Become a Martian
2. First day at MarsBased
3. Buddy System
4. Who is who
5. Company culture
6. What influenced us
7. Talks & Podcasts
8. What we do
9. How we work
10. How we communicate
11. Whom to ask
12. Our rituals
13. Development
14. Project types
15. Current projects
16. Benefits & Perks
17. Holidays, time off & paid leave
18. Digital disconnection policy
19. Travel policy
20. Careers at MarsBased
21. Software and device usage policy

Our guides

For now, we have the following resources available:

1. AI guidelines

   1. MarsBased AI guidelines
   2. Prompt engineering basics

2. Project management & collaboration

   1. Project management guidelines
   2. Linear guidelines
   3. Calendar, Slack & Linear working hours and status guidelines
   4. File storage, permissions & security

3. Marketing & brand

   1. Branding guidelines
   2. Our SEO guidelines for new projects
   3. Our GEO guidelines for new projects
   4. Our blogging guide
   5. How to write a damn good blog post

Engineering guides

1. Engineering workflow

   1. AI Augmented Development
   2. Coding guidelines
   3. Our Git & Commit guidelines
   4. Code reviews guidelines
   5. Testing guidelines
   6. Our Docker guides

2. TypeScript guidelines

3. Frontend & mobile

   1. React guidelines
   2. React Native guidelines
   3. CSS guidelines
   4. Our schema.org implementation guidelines

4. Backend & architecture

   1. Back-end guidelines
   2. Ruby & Rails guidelines
      1. ActiveRecord guide
      2. Rails patterns
         1. Presenter
         2. Command
         3. Form Composition
         4. Query Object

Security guidelines

1. Overview
2. Protect Yourself
3. Protect Your Devices
4. Web Application Security Features
5. Common attack vectors
6. Admin panel protection
7. User accounts protection
8. Cookies best practices
9. Security related headers
10. Periodical Maintenance Tasks
11. Securing backups
12. Sensitive data in logs
13. 3rd Party Software Integrations
14. Off-Boarding

Accessibility guidelines

1. Accessibility guidelines
2. Accessibility for designers
3. Accessibility for engineers
4. Resources

Other useful resources

1. MarsBased website
2. MarsBased blog
3. Life on Mars - The MarsBased Podcast, English Edition
4. Life on Mars - The MarsBased Podcast, Spanish Edition
5. MarsBased newsletter
6. MarsBased YouTube channel

Contributing

We encourage you to contribute! Please check out the Contributing guides for guidelines about how to proceed. ​