oh-my-fullstack

oh-my-fullstack is a full-stack web application skeleton (boilerplate) from GitHub user oh-my-c0de that combines Next.js server-side rendering with Redux state management, RxJS streams via redux-observable, Immutable.js data structures, and an Express server in one clone-and-run starter kit.

What is oh-my-fullstack?

oh-my-fullstack is a full-stack boilerplate that gives you a working isomorphic application out of the box. You clone the repository, install dependencies with Yarn, and start the development server on localhost:3000 with a single command. The project bundles a Next.js front end for server-side rendering, Redux for predictable state, redux-observable (RxJS-based middleware) for handling async side effects, Immutable.js for immutable state updates, and an Express server for the backend and custom API routes. The repository is maintained by GitHub account oh-my-c0de and carries a Code Climate maintainability badge, though no explicit version or release information is shown on the page. The project is licensed under the Beerware license, which permits free use and modification as long as you buy the author a beer if you meet.

Key Features

• Isomorphic rendering with Next.js — Pages render both on the server and client, giving you SEO-friendly output and faster first paint without extra configuration.
• Redux with redux-observable — State is managed through Redux, and asynchronous logic like API calls is handled with RxJS epics, making complex data flows declarative and testable.
• Immutable.js integration — State objects are kept immutable, helping avoid accidental mutations and simplifying state change tracking in a large application.
• Express backend — A small Express server serves the Next.js app and can be extended to add REST endpoints, proxying, or middleware.
• PM2 production scripts — Yarn commands include prod:start, prod:stop, and prod:restart, which manage the app with PM2 for process keeping and zero-downtime restarts in production.
• Environment configuration — You can override variables like NODE_ENV and PORT by creating a .env file in the project root; all used variables are defined in configs/index.js and server/config.js.
• Linting included — Run yarn lint to check code style across the project, helping keep contributions consistent.
• Production build script — yarn build compiles a minified production bundle ready for deployment.

Who is it for?

• Full-stack JavaScript developers who want a convention-based skeleton that already wires together Next.js, Redux, RxJS, and Express, saving hours of boilerplate setup.
• Teams adopting isomorphic React who need server-side rendering without building the plumbing themselves; the template shows one working pattern for SSR with Next.js.
• Developers learning reactive state management who want to see a real project where redux-observable epics are used alongside Redux and Immutable.js to handle asynchronous actions.
• Hobbyists and open-source contributors who want a permissively licensed starting point (Beerware) that they can freely fork, modify, and use in personal projects.

What can you do with it?

• Kickstart a new web application: Clone the repo, rename it, and immediately start building pages and API routes on a working SSR stack without configuring Webpack, Babel, or Redux middleware by hand.
• Learn how React, Redux, RxJS, and Express fit together: The skeleton provides a working reference for patterns like connecting Redux to Next.js and handling async actions with RxJS, so you can study and extend the code.
• Deploy with PM2: Use the provided prod:start script to launch the built app under PM2, giving you automatic restarts, log management, and a straightforward Node.js production deployment path.

How does it work?

1. Clone the repository from https://github.com/oh-my-c0de/oh-my-fullstack.git into a new folder named my-fullstack.
2. Run yarn to install npm dependencies.
3. Start the development server with yarn start, then visit http://localhost:3000.
4. For production, run yarn build first and then start the app with yarn prod:start using PM2.

FAQ

What is oh-my-fullstack?

oh-my-fullstack is a GitHub boilerplate that provides a pre-configured full-stack JavaScript application. It combines Next.js for server-side rendering, Redux and redux-observable for state and side-effect management, Immutable.js for immutable state, and Express for the backend.

Which technologies does it use?

The skeleton is built with Next.js, React, Redux, RxJS (via redux-observable), Immutable.js, and Express. The front end is rendered with Next.js, the state layer uses Redux with Immutable.js, and asynchronous flows are handled through redux-observable epics.

How do I start the development server?

Clone the repository, run yarn to install dependencies, and then run yarn start. The app will be available at http://localhost:3000 in development mode.

Is oh-my-fullstack free to use?

Yes. The project is licensed under the Beerware license, which allows you to use, modify, and redistribute it freely. The only condition, if you ever meet the author, is to buy them a beer.

Does it include a styling solution?

The README does not mention any CSS framework, styled-components, or Tailwind CSS integration. Styling is left entirely to you, so you can add your own CSS approach.